仕組み
セッション開始時、フック（Hook）が praxis:using-praxis スキルを注入します。ユーザーメッセージごとに、エージェントは：
- スコープとトポロジーの分類: 診断表を使ってインラインで分類します（追加のスキル呼び出しは不要）。
- 宣言: スコープ（複数リポジトリの場合は
topology=multi-moduleも含む）を宣言し、必要なスキルを並列でロードします。 - 実行: ロードされたスキルの指示に厳密に従い、
<gate>マーカーを尊重します。
診断宣言フォーマット
毎回の応答はスコープ分類行で始まります：
praxis: scope=<x>, loading=<skills> # 単一モジュール (デフォルト)
praxis: scope=<x>, topology=multi-module, loading=<skills> # マルチモジュール| スコープ (Scope) | 信号 | ロードされるスキル |
|---|---|---|
| vague | 問題空間が未定義 — 何を作るか未定 | design |
| trivial | 誤字修正、改名、ドキュメントのみ、≤1 行、質問 | none |
| small | 単一関数、単一ファイル、≤50 LOC | tdd |
| standard | 機能追加またはソースコード変更 | design, plan, tdd, review |
| complex | 新システム、≥5 タスク、並行編集 | design, plan, worktree, subagents, review, ship |
| debug | バグ、デグレ、失敗テスト | debug |
| onboard | 既存プロジェクト、tech-spec.md なし | onboard |
ライフサイクルの主要ゲート
- 仕様レビュアーゲート (
design): 仕様ドラフト後、トリガー条件に基づいて並列レビュアー（spec-compliance,state-machine,cross-rule,cross-module,safety,implementability）を起動。Coordinator が計画引き渡し前に批判的統合を実施。 - 3次元品質ゲート (
tdd/review): 実装サイクルをメカニカルチェック、規約遵守、設計の結合度/凝集度、ドキュメントカバレッジの4観点から検証。 - モデル階層別起動 (
subagents): ファンアウトタスクに ROLE 契約（implementer,spec-reviewer,quality-reviewer）と能力階層（fast,balanced,strongest）を指定。 - リビングドキュメント同期 (
ship/archive): ステージング仕様をリビングドキュメント（docs/tech-spec.mdまたはdocs/specs/*.md）に統合し、CHANGELOG を更新してクリーンアップ。
フローの例
軽微な修正
You: fix the typo "teh" in README
Agent: scope=trivial → 編集 → 完了標準機能
You: add OAuth login with GitHub
Agent: scope=standard → design (仕様 + 仕様レビュアーゲート) → plan → tdd (品質検証) → review → shipマルチモジュール変更
You: add a shared checkout flow across api and web repos
Agent: scope=complex, topology=multi-module → design (Coordinator 仕様) → plan → リポジトリごとの subagents → ship