Build Software with Discipline
A universal, tech-agnostic development process framework. Every feature starts as a discussion, gets designed, becomes a plan, and ships as clean, tested code. Works for any project. Any language. Any stack. Any team size.
The 7-Stage Lifecycle
Every feature follows the same disciplined path from idea to production. No shortcuts. No skipped steps.
Discuss
Capture the WHY
Design
Architect the HOW
Plan
Break into tasks
Approve
Human gatekeep
Build
Implement & test
Ship
Merge & deploy
Reflect
Review & learn
Discuss → Design → Plan → Approve → Build → Ship → Reflect
Why MASTERY.md?
One Markdown file. Complete development process. Drop it into any project.
Tech-Agnostic
Works with any language, any framework, any stack. From Go to Python to Rust to JavaScript — the process stays the same.
AI-Native
Built-in AI Agent Protocol. AI agents load context, follow autonomy boundaries, and hand off sessions cleanly. Human or AI-driven.
Single File
One Markdown file defines the entire process. Copy mastery.md into your project’s docs/ folder and go.
Any Team Size
Solo developer? 100-person team? The framework scales from side projects to enterprise software without changing the process.
Full Lifecycle
From discussion to deployment. Includes document templates, git strategy, commit conventions, parallel feature support, and hotfix workflows.
Open Source
MIT licensed. Free forever. Use it, modify it, share it. The framework belongs to the community.
AI-Powered Workflow
The mastery-mcp-server is a Model Context Protocol server that gives AI agents structured access to your project’s Mastery docs. AI models can read context, check progress, and follow the process — just like a human developer.
- ✓ Load project context automatically on session start
- ✓ Read discussion, architecture, and task docs
- ✓ Follow autonomy boundaries and approval gates
- ✓ Submit feedback directly to this site via API
{
"mcpServers": {
"mastery": {
"command": "npx",
"args": [
"mastery-mcp-server",
"--project-dir",
"."
]
}
}
}Get Started in 3 Steps
Add MASTERY.md to any project in under a minute.
Copy the file
Initialize docs
Create project-discussion.md, project-context.md, and project-roadmap.md in your docs/ folder.
Start building
Follow the lifecycle: Discuss → Design → Plan → Approve → Build → Ship → Reflect.