# .decapod - Decapod Project Metadata 🦀✨

Welcome to the control-plane directory for this repo.

## Quick Start

1. **Initialize**: Run `decapod init` to set up your project
2. **Configure overrides**: Edit `OVERRIDE.md` to customize behavior
3. **Read docs**: Use `decapod docs show <path>` to read constitution docs

## How to Use Overrides

The embedded constitution (read-only, shipped with Decapod) provides the base methodology. The `OVERRIDE.md` file lets you customize behavior without forking Decapod.

**To add an override:**

1. Find the component section in `OVERRIDE.md` (Core, Specs, Interfaces, Methodology, Architecture, or Plugins)
2. Scroll to the specific component you want to override (e.g., `### plugins/TODO.md`)
3. Write your override content under that heading
4. Use markdown formatting for your overrides
5. Commit this file to version control

**Example override:**

```markdown
### plugins/TODO.md

## Priority Levels (Project Override)

For this project, we use a 5-level priority system:
- **critical**: Production down, blocking release
- **high**: Sprint commitment, must complete this iteration
- **medium**: Backlog, next sprint candidate
- **low**: Nice-to-have, future consideration
- **idea**: Exploration, needs refinement before actionable
```

## Available Override Sections

- **Core**: DECAPOD.md, INTERFACES.md, METHODOLOGY.md, PLUGINS.md, GAPS.md, DEMANDS.md, DEPRECATION.md
- **Specs**: INTENT.md, SYSTEM.md, AMENDMENTS.md, SECURITY.md, GIT.md
- **Interfaces**: CLAIMS.md, CONTROL_PLANE.md, DOC_RULES.md, GLOSSARY.md, STORE_MODEL.md
- **Methodology**: ARCHITECTURE.md, SOUL.md, KNOWLEDGE.md, MEMORY.md
- **Architecture**: DATA.md, CACHING.md, MEMORY.md, WEB.md, CLOUD.md, FRONTEND.md, ALGORITHMS.md, SECURITY.md, OBSERVABILITY.md, CONCURRENCY.md
- **Plugins**: TODO.md, MANIFEST.md, EMERGENCY_PROTOCOL.md, DB_BROKER.md, CRON.md, REFLEX.md, HEALTH.md, POLICY.md, WATCHER.md, KNOWLEDGE.md, ARCHIVE.md, FEDERATION.md, FEEDBACK.md, TRUST.md, CONTEXT.md, HEARTBEAT.md, TEAMMATE.md, VERIFY.md, DECIDE.md, AUTOUPDATE.md

## Contents

- `OVERRIDE.md`: **Edit this file** to override the embedded decapod constitution for project-specific needs.
- `data/`: **DO NOT TOUCH**. This is persistent storage (SQLite databases and event logs) used by your agent(s) and decapod.
- `generated/`: **DO NOT TOUCH**. Artifacts generated by decapod.