Core Features

Everything you need for deterministic AI-human collaboration

Workflow Management

Folder-based lifecycle with built-in safety and validation

🔄

Lifecycle Management

Clear state transitions: backlog → in-progress → review → done. Folder location is the source of truth.

🛡️

Multi-Agent Safety

Built-in concurrency controls with ownership locks and collision prevention.

✅

Validation & Indexing

Automated validation rules and index generation for Markdown, JSON, and HTML.

🔧

Pre-commit Hooks

YAML validation, JSON formatting, spell checking, and file integrity checks.

📝

Markdown Linting

Python-based markdown linting with PyMarkdown for consistent formatting.

🎯

CI/CD Ready

GitHub Actions workflows with validation rules and automated indexing.

Concurrency & Safety

Built-in locking mechanisms ensure multiple agents can work safely without conflicts

🔒

Soft Lock via Owner

Only the current owner may edit a spec outside of trivial fixes.

⏰

Hard Lock with TTL

Optional hard locks with time-to-live prevent stale ownership.

🚫

Collision Detection

Agents detect conflicts and abort with clear handoff procedures.

Project Structure

Simple, intuitive folder-based organization

my-project/
├── features/              # Feature specifications
│   ├── backlog/           # Unassigned features
│   ├── in-progress/       # Features being worked on
│   ├── blocked/           # Features waiting on dependencies
│   ├── review/            # Features ready for review
│   ├── done/              # Completed features
│   └── INDEX.md           # Auto-generated feature index
├── templates/             # Templates and configuration
│   ├── spec.md            # Feature spec template
│   ├── pr-template.md     # Pull request template
│   └── rules.yml          # Agent rules configuration
├── schemas/               # Validation schemas
│   └── frontmatter.schema.json
├── agents/                # Agent documentation
│   ├── pm.md              # Project manager prompt
│   ├── architect.md       # System architect prompt
│   ├── backend_dev.md     # Backend engineer prompt
│   └── frontend_dev.md    # Frontend engineer prompt
├── scripts/               # Automation scripts
│   ├── ftr-new.sh         # Create new feature
│   ├── ftr-move.sh        # Move feature between states
│   ├── ftr-validate.sh    # Validate features
│   └── ftr-index.sh       # Generate feature index
└── .pre-commit-config.yaml # Pre-commit hooks

Frontmatter Schema

Structured metadata for every feature specification

id: FTR-0123
title: User Authentication
status: backlog # backlog | in-progress | blocked | review | done
owner: unassigned # set to human/agent handle when in-progress
priority: P2 # P0 | P1 | P2 | P3
complexity: M # XS | S | M | L | XL
created: 2025-09-16
updated: 2025-09-16
labels: [auth, frontend, security]
dependencies: [FTR-0101, FTR-0110]
epic: EP-0005