# AGENT.md — CapInt

CapInt is an IDE-native, capability-first orchestration engine.

> **Maintainer repo:** read [HANDOFF.md](HANDOFF.md) first · dogfood: [docs/maintainer-dogfood.md](docs/maintainer-dogfood.md)

## Task contract

For every task:
1. Build Execution Intent
2. Adaptive confirm: light → apply after Intent; medium/heavy → short Turkish question (devam/plan/analiz — no token required)
3. Route via capability + provider resolution

## Activation model

- **`installed`** = `skills/<name>/SKILL.md` exists on disk **and** skill is not disabled (`capint skill list`).
- **Installed ≠ Cursor skill picker** — CapInt does not register 115 skills in IDE UI; the agent reads files per task.
- Before medium+ code edits: read `skills/prismx-skill-gateway/SKILL.md`, then the routed skill from `explanation.files_to_read`.
- Show the **Explanation** block (max 8 lines) before applying on medium+ tasks.
- Preview routing: `capint route "<task>"` — check **Explanation** block.

## Runtime chain

`parseIntent -> routeCapability -> resolveMemoryStrategy -> buildExecutionPolicy -> formatOutput`

## Scope

- Keep user UX minimal and chat-first.
- Do not force users to remember skill/workflow names.
- Memory strategy is silent and additive (`none|optional|required`); providers default off.
- Medium/heavy tasks require verification evidence before claiming done.

## Commands

- `capint route` — execution intent
- `capint consult` — dry-run recommendation
- `capint status` / `capint doctor` / `capint audit` — health (no auto-fix)
- `capint init` / `capint scaffold` — hybrid project bootstrap
