# Technical reference — AIOSON (EN)

> This folder contains technical reference documentation for CLI commands, features, and integrations.
> **Starting from scratch?** Go to [`2-start/`](../2-start/first-project.md) (in progress — translated from PT).
> **Want a worked recipe?** Go to [`3-recipes/`](../3-recipes/README.md).

This layer currently holds the original EN feature guides. Additional reference docs (feature-dossier, agent-chain-continuity, sdd-framework, live-sessions, secure-by-default, aioson-com-store, and the full set from `docs/pt/5-referencia/`) will be progressively added as the PT documentation is translated.

---

## CLI & automation

| Document | Description |
|---|---|
| [cli-reference.md](./cli-reference.md) | Full reference for every CLI command |
| [json-schemas.md](./json-schemas.md) | `--json` output contracts for all commands |
| [executable-verification.md](./executable-verification.md) | The executable-verification theme: `verification` + `harness:check`, fresh-context validator, `spec:analyze`, Wave markers, Lane B (`forge:compile` + `@forge-run`) |
| [autopilot-handoff.md](./autopilot-handoff.md) | Streamlined canonical handoffs through Product → Sheldon → Planner → DEV → QA; bounded stops and human close/publish gate |
| [agent-execution.md](./agent-execution.md) | Feature-scoped manifests, generic development lanes, safe host/model resolution, explicit fallback, bound reports, and telemetry |
| [runtime-storage.md](./runtime-storage.md) | Per-clone local database, command/table map, guarded retention, compaction, and Neo maintenance |
| [output-strategy-delivery.md](./output-strategy-delivery.md) | File-first squad outputs, local runtime indexing, delivery, and legacy migration |

---

## Features

| Document | Description |
|---|---|
| [mcp.md](./mcp.md) | MCP setup: `mcp:init`, `mcp:doctor`, Context7 and Database connectors |
| [parallel.md](./parallel.md) | Parallel orchestration: `parallel:init`, `parallel:assign`, lanes, merge |
| [qa-browser.md](./qa-browser.md) | Browser QA with Playwright: `qa:run`, `qa:scan`, personas |
| [squad-dashboard.md](./squad-dashboard.md) | Real-time squad monitoring panel |
| [operator-memory.md](./operator-memory.md) | Identity-scoped operator decisions, signal promotion, idempotent reinforcement, and CLI operations |

---

## Internationalization

| Document | Description |
|---|---|
| [i18n.md](./i18n.md) | Adding locales, `i18n:add`, `locale:apply`, built-in locales |

---

## Web3

| Document | Description |
|---|---|
| [web3.md](./web3.md) | Web3 support: Ethereum (Hardhat/Foundry), Solana (Anchor), Cardano (Aiken) |

---

## Release engineering

| Document | Description |
|---|---|
| [release.md](./release.md) | Release process and versioning |
| [release-flow.md](./release-flow.md) | CI/CD release flow |
| [release-notes-template.md](./release-notes-template.md) | Template for writing release notes |

---

## Coming from docs/pt/5-referencia/

The following docs exist in PT and will be translated progressively:
`feature-dossier` · `agent-chain-continuity` · `sdd-framework` · `live-sessions` · `secure-by-default` · `aioson-com-store` · `memoria-e-contexto` · `runtime-observability` · `hooks-session-guard` · `fluxo-artefatos` · `feature-archive` · `design-docs-governance` · `sandbox` · `agent-sharding` · `genome-distribution` · `clientes-ai` · `sdd-planos-e-estrutura`
