ai: Establish conductor documentation and governance framework#4780
Merged
jamesarich merged 13 commits intomainfrom Mar 13, 2026
Merged
ai: Establish conductor documentation and governance framework#4780jamesarich merged 13 commits intomainfrom
jamesarich merged 13 commits intomainfrom
Conversation
This commit introduces a comprehensive "conductor" directory to manage project workflow, technical standards, and historical archives. This structure centralizes project state and decision-making processes to align with 2026 Kotlin Multiplatform (KMP) best practices. Key changes include: - **Core Governance**: Added `workflow.md`, `tech-stack.md`, and `product.md` to define development protocols, the KMP-focused stack (Koin 4.2, Navigation 3, Compose Multiplatform), and product vision. - **Documentation Consolidation**: Introduced `doc-consolidation-plan.md` to prune redundant session artifacts and synthesize status reports into a single historical record. - **Track Management**: Created an archive of major project tracks (Hardware Transport Extraction, Desktop Parity, Doc Consolidation) including specifications, implementation plans, and metadata. - **Style & Quality**: Added general code style principles and defined a "Definition of Done" that mandates TDD and >80% code coverage. - **Administrative**: Established an `index.md` as a entry point for project context and a `tracks.md` registry for ongoing initiatives. Signed-off-by: James Rich <[email protected]>
…tion' as complete
…s for quality and veracity against the current codebase and recent changes - use tooling as needed. Evaluate updating project documentation for clarity and context. Synthesize and condense documentation and plans as needed. Be sure to thoroughly investigate the current state of the codebase and it's migration to kmp.' as complete
…docs for quality and veracity against the current codebase and recent changes - use tooling as needed. Evaluate updating project documentation for clarity and context. Synthesize and condense documentation and plans as needed. Be sure to thoroughly investigate the current state of the codebase and it's migration to kmp.'
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.
This pull request significantly overhauls the documentation for the Meshtastic-Android project, focusing on improving clarity, structure, and comprehensiveness for both AI agents and developers. The new documentation provides a detailed architectural overview, stricter development and execution protocols, an updated codebase map, and improved troubleshooting guidance. It also enforces continuous documentation sync with code changes and clarifies strict rules for platform purity and testing.
Key documentation and guidance improvements:
1. Architectural and Codebase Clarity
2. Development and Execution Protocols
3. Coding Standards and Best Practices
4. Documentation and Agent Guidance
AGENTS.mdas the primary source of truth, with mirrored guidance in.github/copilot-instructions.md.5. Troubleshooting and Support
These changes collectively make the documentation more actionable, maintainable, and accessible for both human and AI contributors, reducing onboarding friction and improving project consistency.