Add AI-optimized documentation (ai-docs)#30
Merged
Conversation
Introduce AI-optimized documentation for the Splat Team, following the agentic-docs pattern from OpenShift enhancements. This provides structured, retrieval-first documentation for AI coding agents. Structure: - AGENTS.md: Master navigation index (211 lines) - ai-docs/TEAM_PHILOSOPHY.md: Core team principles and methodology - ai-docs/architecture/: Projects overview and tech stack - ai-docs/statuses/: Complete status workflow state machine - ai-docs/roles/: Hat-switching guide for superman role - ai-docs/workflows/: Process guides (indexes created, content coming) - ai-docs/practices/: Engineering standards (indexes created) - ai-docs/decisions/: ADR template and index - ai-docs/references/: Glossary and quick reference Key Features: - Retrieval-first guidance (read docs, not training data) - Task-based navigation flows - Explicit hat-switching for superman role - Human gate documentation - vSphere platform focus - OpenShift CI/CD integration Total files: 14 new markdown files Total lines: ~3,200 lines Generated using prototype ai-docs generation skill based on scrum-compact profile and codebase analysis. Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
✅ Deploy Preview for illustrious-arithmetic-3670b4 ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
Generated using the new scrum-compact profile templates from bm enrich implementation. This updates the team-level ai-docs to use the standardized template structure. Changes: - Updated AGENTS.md with improved navigation - Refreshed TEAM_PHILOSOPHY.md with template structure - Updated workflows, roles, and statuses documentation - Added sprint-process.md with comprehensive sprint workflow Generated with: bm enrich generate splat --team-only Co-Authored-By: Minty <minty@botminter.dev>
The monitor-active-prs skill was re-processing the same PRs on every scan cycle because the idempotency check was too strict. Changes: - Replace phrase-specific comment checks with timestamp-based checks - Look for ANY bot comment after the review time, not just specific phrases - Apply same fix to both 'changes requested' and inline comment checks - Add documentation in superman-atlas knowledge base This prevents duplicate event emissions for PRs that have already been responded to.
PRs can receive important feedback even after merge (security concerns, late reviews, follow-up questions). Story status should not prevent PR monitoring. Changes: - Check both open AND recently merged PRs (last 7 days) - Story 'done' status no longer prevents PR feedback monitoring - Post-merge comments are now caught and responded to - Updated documentation to clarify this behavior This ensures critical post-merge feedback is not missed.
Resolved conflicts in monitor-active-prs/SKILL.md by combining: - Improved idempotency check using BOT_RESPONSE_COUNT (from add-ai-docs) - Epic branch support and FEEDBACK_EVENT variable (from main) - Recently merged PR monitoring (from add-ai-docs) All changes preserved from both branches.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Introduces AI-optimized documentation for the Splat Team, following the agentic-docs pattern from OpenShift enhancements (openshift/enhancements#1992).
This provides structured, retrieval-first documentation specifically designed for AI coding agents to navigate and understand team processes, roles, and workflows.
What's Included
Core Navigation
Documentation Structure
Key Features
✅ Retrieval-First Guidance - Explicit instructions to prefer docs over training data
✅ Task-Based Navigation - "If you want to X, read docs A → B → C"
✅ Scoped Reading - "Read 4-5 docs, not everything"
✅ Hat-Switching Clarity - Explicit role transitions for superman workflow
✅ Human Gate Documentation - Clear SLAs and approval requirements
✅ vSphere Platform Focus - Tailored to team's OpenShift vSphere work
✅ OpenShift CI/CD Integration - Prow, must-gather, and upstream conventions
Stats
Generation Method
This is a manual prototype of the proposed
bm enrichcommand from the ai-docs integration design. Generated by:Next Steps
After review:
bm teams syncReferences
/home/splat/.config/botminter/minty/AI_DOCS_INTEGRATION.md/home/splat/.config/botminter/minty/examples/profile-templates/scripts/detect-tech-stack.sh🤖 Generated with Claude Code (manual prototype of
bm enrichcommand)