Cortex TMS
Documentation Scaffolder & Governance for AI Coding Agents
Validate governance docs. Detect staleness. Maintain structure.
Modern AI agents need governance. Cortex validates that your documentation stays current and well-structured—in CI or locally.
See It In Action
From the Blog
Cortex TMS Dogfooding Results: Quality Over Token Count
What we learned building Cortex with Cortex: governance documentation improves code quality, but token savings claims were overstated. Here are the real results and what matters.
Three Pillars, Measurable Results
Consistency
Scaffold governance docs AI agents actually read. PATTERNS.md, CLAUDE.md, ARCHITECTURE.md keep your AI aligned with YOUR standards.
Impact: Pattern violations reduced by 80%
Freshness
Detect when governance docs go stale relative to code changes. Git-based staleness detection catches drift before AI agents read outdated docs.
Impact: Docs stay current with code
Safety
CLAUDE.md governance rules enforce human approval for git operations, prevent scope creep, and keep AI agents aligned with project standards.
Impact: Human oversight enforced
We dogfood everything. This project uses Cortex TMS to build itself—our NEXT-TASKS.md tracks development, our PATTERNS.md guides AI collaboration, and our Guardian CLI reviews every commit. ◢ Cortex TMS Team
Your Project at a Glance
One command.
Complete visibility.
The Cortex TMS dashboard gives you a real-time terminal UI showing governance health, documentation freshness, and sprint progress — all without leaving your terminal.
--live mode: auto-refreshes every 5 seconds --live Guardian CLI: Semantic Validation
Guardian CLI
AI-Powered Semantic Validation
Compare Your Options
Cortex TMS provides automated governance and quality assurance for AI-assisted development.
Quality AI Development
Keep AI Agents Aligned
Modern AI agents are powerful but can drift from your standards. Cortex TMS validates that governance docs stay current and well-structured—preventing stale documentation from misleading AI.
Fresh
STALENESS DETECTION
Catches outdated docs
CI/CD
AUTOMATED CHECKS
Validation in GitHub Actions
Patterns
CONSISTENCY
AI follows YOUR standards
Quick Installation
How It Works
Tiered Documentation
Organize documentation by access frequency. HOT files (current sprint) are always read, WARM files (architecture) are on-demand, and COLD files (archives) are ignored—keeping AI focused on what matters.
Guardian Validation
AI-powered semantic validation against PATTERNS.md and DOMAIN-LOGIC.md. Guardian catches pattern drift that grep and regex miss. Safe Mode (--safe) shows only high-confidence violations to reduce false positives.
Staleness Detection
Git-based freshness checks detect when governance docs go stale. Configurable thresholds flag docs that haven't been updated while code evolved around them.
Essential Prompts
Project-aware AI prompts guide you through the entire development lifecycle—from init-session to feature implementation to code review. One command copies the right prompt to your clipboard.
Bring Your Own Key
Guardian uses your OpenAI or Anthropic API key—full privacy and control. API keys are automatically sanitized in all error messages and logs. No data leaves your machine except API calls you authorize.
Terminal Dashboard
cortex-tms dashboard launches a full-screen interactive terminal UI. Navigate three views with number keys: governance health score, staleness status, sprint progress, HOT files, and validation results—all in real time with --live mode.
Get Started in 3 Steps
Initialize
Run cortex-tms init to scaffold governance documentation—task management, patterns, and AI agent configuration. Everything is preconfigured with best practices.
Work with AI
AI agents read your governance docs and follow established patterns. Consistent documentation structure means consistent, high-quality code output.
Validate Health
Run cortex-tms validate to check documentation health—staleness detection, structure validation, and size limits. Use --strict in CI to catch issues early.
Ready to Get Started?
Ready to Get Started?
Install Cortex TMS and scaffold your first project in under 5 minutes. Join the growing community of teams using governance documentation.