---
schema_version: "1.0"
type: project-instruction
---

# {{project_name}} — Orchestrator Project Instructions

<!-- This file is auto-generated by `orchestrator:init` and refreshed by
     re-running init. Custom content should live inside the
     `<!-- BEGIN CUSTOM -->` / `<!-- END CUSTOM -->` markers below — reinit
     preserves that block verbatim. -->

## Project Overview

- Project type: `{{project_type}}`
- Primary language: `{{language}}`
- All languages detected: `{{languages_all}}`
- Primary framework: `{{framework}}`
- All frameworks detected: `{{frameworks_all}}`
- CI system: `{{ci_system}}`
- Tools detected: `{{tools_detected}}`
- Has tests: `{{has_tests}}`
- Git repo: `{{has_git}}`

## Detected Capabilities

- Execution mode: `{{cap_execution}}`
- Graph database available: `{{cap_graph}}`
- MCP servers available: `{{cap_mcp}}`
- CI pipeline integration: `{{cap_ci}}`
- Subagent dispatch: `{{cap_subagent}}`
- Capability score: `{{cap_score}}` / 5

## Detected Runtime

- Runtime: `{{runtime}}`
- Detection confidence: `{{runtime_confidence}}`
- Instruction file location: `{{instruction_file_path}}`
- State root: `{{state_root}}`

## Orchestrator Conventions

The orchestrator stores state under `{{state_root}}`. Key locations:

- `{{state_root}}/config.yml` — project configuration
- `{{state_root}}/milestones/` — milestone state (roadmaps, phases, tasks)
- `{{state_root}}/KNOWLEDGE.md` — consolidated patterns and lessons

Commands are invoked via the `orchestrator:*` namespace. Recommended starting points:

- `orchestrator:evaluate` — classify scope of a new feature
- `orchestrator:roadmap` — decompose a feature into phases
- `orchestrator:auto` — run autonomous execution on a planned milestone
- `orchestrator:status` — check current progress

See `{{state_root}}/../references/` for full documentation (if installed alongside this project).

## Intensity Defaults

Based on detected capabilities (score `{{cap_score}}`/5), the recommended
default intensity for this project is `{{recommended_intensity}}`. Override
per-task via `--intensity quick|standard|full` on the initial evaluate
or roadmap invocation.

<!-- BEGIN CUSTOM -->
<!--
  Add project-specific instructions here. This block is preserved
  verbatim across `orchestrator:init` reruns (unless --force is used).

  Examples:
  - Coding conventions the orchestrator should follow.
  - Files or directories that are off-limits for automated changes.
  - Project-specific hook or verification commands.
-->
<!-- END CUSTOM -->

---

*Generated by orchestrator:init on `{{initialized_at}}`. Run `orchestrator:init`
again to refresh auto-filled sections; use `orchestrator:init --force` to
regenerate everything including the custom block.*
