Features

Everything you need for AI-human feature collaboration in one template

Template Features

🔄 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.

Project Structure

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

Code Quality & Development Tools

🔧 Pre-commit Hooks

Automated checks before every commit including YAML validation, JSON formatting, spell checking, and file integrity checks.

📝 Markdown Linting

Python-based markdown linting with PyMarkdown, configurable via .pymarkdown.json for consistent formatting.

✅ Spell Checking

Automated spell checking for Markdown, YAML, and text files with configurable dictionaries and ignore patterns.

🎨 Code Formatting

Automatic formatting for YAML and JSON files ensuring consistent code style across the project.

Concurrency & Safety

Built-in locking mechanism ensures 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.

Frontmatter Schema

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