tierward

Tierward

Claude が生成し、あなたやチームが判断します。 Claude Code に統制の取れた段階的なプロセスを与え、初日から一貫性があり、レビュー可能な形で実用的なソフトウェアを構築できる開発フレームワークです。 MCP ネイティブ：Claude Desktop、ChatGPT、Cursor、VS Code から Tierward のガバナンス状態を読み取れます。

Claude Code は高速です。問題はコードではなく、レビューにあります。AI がすべてを自律的に書くと、十分に理解していない差分を承認したり、2つ先のブロックでリグレッションに気づいたり、システムが実際に何をするのか把握できなくなったりします。

Tierward は Claude と完了のあいだに位置します。チームは、プロセスを設けない探索用のセットアップから、完全に統制されたパイプラインまで、段階的に導入できます。実装前の明示的な STOP ゲート、本番環境に届く前に問題を見つける監査スキル、そして Claude が完了を告げた際にテストを実行し、失敗した場合は修正のために作業へ戻す Stop フックを備えています。Tier 0 から始め、より多くの構造が必要になった段階で上位へ進んでください。

v1.17.0 以降、Tierward は CLI とともに MCP サーバーを提供しています。MCP 対応クライアントなら、Tierward CLI を実行せずに、プロジェクトの doctor レポート、team-settings ポリシー、直近の arch-audit、スキルの一覧を読み取れます。MCP サーバーをご覧ください。

---

哲学

Tierward の根底にあるのは、ひとつの考えです。Claude Code が扱いにくくなるのは、能力が低下するからではありません。自律的な判断が、誰もレビューできない速さで積み重なるからです。このパイプラインは、レビューの取り決めを徹底します。コードを書く前にスコープを確認し、修正前に仮説を記述し、完了前にテストを通します。そのような構造を必要としない作業の速度は落としません。

プロセスにはコストがあるため、Tier システムが用意されています。単独で行うバグ修正に、チーム向け機能開発のワークフローの負担をかけるべきではありません。幅広いニーズに対応する2つのパイプラインがあります。すばやい修正向けの Fast Lane（4ステップ、スコープ確認）と、チーム向け機能開発の Full（14フェーズ、4つのレビューゲート）です。どちらも同じ取り決めを徹底します。Claude はフェーズごとに作業し、チームは各ステップを承認します。現在のリスクに合う Tier から始め、重要度が上がるにつれて構造を追加してください。

プロダクトマネージャーと開発者を問わず、成果を担う人々のために構築されています。判断をモデルではなく、その人たちの手に委ねます。

Claude Code ファーストを設計の基本に

Tierward は Claude Code 専用です。Cursor のサポートも、Copilot レイヤーも、複数のツールを扱う抽象化もありません。これは意図的なものです。

Tierward を有用にする強制の仕組みは、Claude Code のプリミティブです。settings.json の Stop フックは OS レベルで強制的にブロックし、STOP ゲートは Claude がセッション開始時に読むルールファイル pipeline.md にあり、監査スキルは Claude Code のエージェントループ内で実行される構造化プログラムです。これらは、抽象化レイヤーでラップされた移植可能な概念ではありません。Claude Code のアーキテクチャを直接利用しています。

複数のツールをサポートするには、これらを最小公倍数的な抽象化に置き換え、強制のレイヤーを取り除くことになります。Tierward の価値は、まさにこの強制機能にあります。Stop フックは Claude にテストの実行を頼むのではなく、テストに合格するまで Claude がタスクを完了できないようにします。

チームで Claude Code とあわせて他の AI コーディングツールを使っている場合、Tierward が管理するのは Claude Code のセッションのみです。根底にある原則（完了前にテスト、コードを書く前に要件、デプロイ前に監査）は Claude 固有のものではありませんが、実装は意図的に Claude Code 専用としています。

---

仕組み

1. 一度だけスキャフォールドします。 npx tierward init はプロジェクトの種類を検出し、技術スタックとチーム規模に合わせて、パイプライン、監査スキル、セキュリティルール、ガバナンスファイルをスキャフォールドします。セットアップは 2 分もかかりません。

2. パイプラインに沿って作業します。 パイプラインは、Claude がセッション開始時に読むルールファイルです。Tier M では、実装前の依存関係スキャン、要件確認後の STOP ゲート、コード作成後の /simplify が含まれます。手作業で管理しなくても、作業の枠組みを利用できます。

3. 必要に応じて監査スキルを実行します。 /security-audit、/arch-audit、/systematic-debugging などのスキルは、Claude Code 内で実行される複数ステップのプログラムです。デプロイ前、テスト失敗時、移行の各段階の後など、必要なときに呼び出してください。それぞれ構造化されたレポートを生成します。

4. 判断するのはあなた、またはチームです。 STOP ゲートは Claude を一時停止して計画を提示し、コミットゲートは承認するまで git commit をブロックします。コードオーナーに対応する GitHub プランでは、CODEOWNERS により .claude/ への変更が人間のレビュアーに送られ、ブランチ保護でコードオーナーのレビューが必須の場合はマージもブロックされます。さらに Stop フックが、タスクを終了する前にテストの合格を確認します。自動マージはありません。

---

クイックスタート

npx tierward init

ウィザードがプロジェクトの状態を検出し、セットアップ手順を案内します。次の 3 つの方法があります。

方法	使用する場面
既存のプロジェクト	すでにコードがあるプロジェクトに構造を追加する場合
新しいプロジェクト	ゼロから始める場合
既存のドキュメントから	リポジトリやドキュメントを共有すると、Claude が読み込んで内容を反映します

init の後、Claude Code を開いて作業を始めてください。スキャフォールドはすぐに有効になります。

コンテキストビルダー（v1.27.0）

スキャフォールドを一貫して再現できるようにし、依頼内容の記録を残したい場合は、init の前に context を実行してください。

npx tierward context                       # produces CONTEXT.md
npx tierward init                          # reads CONTEXT.md, scaffolds with no further prompts
npx tierward context --all                 # one-shot: context then init
npx tierward context --from-yaml file.md   # bypass interview, validate + copy
npx tierward validate-context              # CI gate: exit 0/1 on schema check

CONTEXT.md は、スキーマ検証に対応したプロジェクトコンテキストファイルです。グリーンフィールドプロジェクトでは、PM 向けのインタビューを行います。既存のリポジトリでは、3 段階の推論を行います。アルゴリズムによる検出、LLM による抽出、ハイブリッド方式の PM レビューです。最初の質問で、PM 向けフローか開発者向けフローかを振り分けます。開発者向けフローでは、従来の init ウィザードの技術的な質問（projectName、stack、commands、scaffold options）を再利用し、チーム規模と作業範囲から tier.rationale を自動的に導出するため、開発者が PM 向けの説明文を書く必要はありません。

v1.27.0 では、スキーマが 4 つのパイプラインティアすべてに対応しています。個人作業またはバグ修正向けの tier 0（Discovery）と tier S（Fast Lane）、フィーチャーフラグ（has_api、has_database、has_frontend、has_design_system、has_prd）を備えた機能ブロック作業向けの tier M（Standard）、そして複雑なドメインプロジェクト向けの tier L（Full）です。

---

機能

4 つのティアすべてで共通の契約です。単独でのバグ修正でも、完全にガバナンスされたチームのパイプラインでも、ルールは同じです。Claude が提案し、チームが承認します。

リスクに合わせたティア別パイプライン

Tier	Pipeline	Best for
0 - Discovery	Stop hook のみ	最初の探索 — プロセス不要
S - Fast Lane	4 ステップ、スコープ確認	1 人の開発者、低リスク、迅速な修正
M - Standard	13 フェーズ、3 つの STOP ゲート	機能ブロック、1～2 人の協力者
L - Full	14 フェーズ、4 つの STOP ゲート	チームプロジェクト、複雑なドメイン変更

Tier 0 から始めます。より強固な構造が必要になったら、より上位のティアを指定して init を再実行します（方法）。

ウィザードでは、変更を main に取り込む方法も尋ねます。staging ブランチ経由（Web スタックのデフォルト）、direct ローカルマージ（ネイティブアプリのデフォルト）、またはプルリクエスト（pr）経由で、ステージングブランチを使用せず、main にプッシュしない方法から選べます（昇格モード）。

27 個の監査スキル

Claude Code 内で実行される、複数ステップの実行可能なプログラムです。プロンプトの指示ではありません。モデルルーティング（機械的なチェックには haiku、分析には sonnet）を備えた、構造化された監査ワークフローです。

• すべてのティア（8 個）： /arch-audit、/security-audit、/perf-audit、/skill-dev、/simplify、/commit、/skill-security、/systematic-debugging
• Tier M と L では 18 個追加： /api-design、/skill-db、/migration-audit、/visual-audit、/ux-audit、/responsive-audit、/ui-audit、/accessibility-audit、/test-audit、/doc-audit、/api-contract-audit、/infra-audit、/compliance-audit、/dependency-audit、/pr-review、/skill-review、/dependency-scan、/repo-hygiene
• Tier L では 1 個追加： /context-review

スキルはプロジェクトに応じて条件付きでインストールされます：hasApi、hasDatabase、hasFrontend、hasDesignSystem。各スキルの機能、インストールされる条件、必要なものについては、監査スキルを参照してください。

11 個の技術スタックを自動検出

Node.js/TS、Node.js/JS、Python、Go、Swift、Kotlin、Rust、.NET、Ruby、Java に加え、汎用フォールバックに対応しています。セキュリティルール、権限、CLAUDE.md のフィールドは自動的に適応します。

MCP サーバー（v1.17.0 以降）

tierward パッケージには、CLI とともに MCP サーバー（tierward-mcp バイナリ）が同梱されており、バージョンが固定されています。npm install -g を 1 回実行するだけでインストールできます。MCP 対応クライアント（Claude Desktop、ChatGPT desktop、Cursor、VS Code、Copilot Studio）なら、Tierward CLI を実行していなくても Tierward のガバナンス状態を照会できます。6 つの読み取り専用ツールで、doctor レポート、team-settings、直近の arch-audit、スキル一覧、パッケージメタデータ、/pr-review のコメントを確認できます。詳しくは、以下のMCP サーバーセクションを参照してください。

Tierward は Claude Code プラグイン（v1.32.0 以降）でもあり、このリポジトリのプラグインマーケットプレイスを通じて配布されています。このプラグインは、commit、arch-audit、security-audit、perf-audit、simplify、skill-dev、skill-security、humanize の 8 つのガバナンススキルを Claude Code に追加します。MCP サーバーは含まれていないため、必要な場合は npm パッケージをインストールしてください。Claude Code（2.1.275 以降）内からプラグインをインストールします：

/plugin install tierward --marketplace marcoguillermaz/Tierward

段階的な導入

完全なスキャフォールドを作成せずに、個別のコンポーネントをインストールできます：

npx tierward add skill security-audit   # install one skill
npx tierward add rule git                # install one rule
npx tierward add rule security           # install the security rule

カスタムスキル（custom-* プレフィックス）はアップグレード後も保持されます。カスタムスキルガイドを参照してください。

---

アーキテクチャ

your-project/
├── CLAUDE.md                    # Project context (<200 lines)
├── .claude/
│   ├── settings.json            # Permissions + Stop hook (mechanical enforcement)
│   ├── team-settings.json       # Team policy: minTier / allowed / blocked / required (v1.16+)
│   ├── rules/
│   │   ├── pipeline.md          # Development workflow (tier-appropriate)
│   │   ├── security.md          # Stack-aware: web / apple / android / systems
│   │   ├── git.md               # Commit format, branch rules
│   │   └── output-style.md      # Communication rules
│   ├── skills/                  # Audit skills (conditional per project)
│   ├── hooks/                   # Governance gates and the audit log hook
│   └── session/                 # Session recovery (gitignored)
├── docs/                        # Requirements, specs, backlog (M/L)
├── .github/                     # PR template, CODEOWNERS
└── .pre-commit-config.yaml      # Secret scanning

settings.json の Stop hook が強制メカニズムです。Claude がタスクを完了しようとすると、テストを実行し、失敗した場合は Claude に修正させます。Discovery を含むすべてのティアで利用できます。

---

CLI コマンド

npx tierward init                    # scaffold wizard
npx tierward init --dry-run          # preview without writing
npx tierward init --answers file.json  # skip prompts (CI/automation)
npx tierward doctor                  # validate setup (28 checks)
npx tierward doctor --report         # JSON output for CI
npx tierward doctor --ci             # silent, exit 1 on failure
npx tierward upgrade                 # refresh safe files, show diffs for the rest
npx tierward upgrade --anthropic     # show diff for Anthropic-influenced files (dry-run)
npx tierward upgrade --anthropic --apply  # write the diff (with .bak backup)
npx tierward add skill <name>        # install one skill
npx tierward add rule <name>         # install one rule
npx tierward new skill               # create a custom skill (wizard)
tierward-mcp                            # MCP server (stdio); wire from .mcp.json

MCP サーバー

tierward-mcp は Model Context Protocol サーバーです。6 つの読み取り専用ツール（doctor レポート、チーム設定、直近の arch-audit、スキル一覧、パッケージのメタデータ、/pr-review のコメント）を通じて、MCP 対応クライアント（Claude Desktop、ChatGPT desktop、Cursor、VS Code、Copilot Studio）から Tierward のガバナンス状態を読み取れるようにします。CLI と MCP サーバーは同じ npm パッケージに同梱され、バージョンが固定されています。読み取り専用の姿勢は v2.1.0 でも変わりません。

Claude Code では、チームで共有する場合はプロジェクトルートの .mcp.json ファイルに追加するか、プロジェクトをまたいで自分用に設定します。

claude mcp add --transport stdio --scope user tierward -- tierward-mcp

ツールのリファレンス、.mcp.json のスニペット、プロジェクトルートの解決方法については、MCP サーバーを参照してください。

---

プロセス制御

Stop フック（すべての tier）- Claude が終了しようとすると、フックがテストを実行し、失敗した場合は終了をブロックするため、Claude は修正に戻ります。同じターン中に Claude が再び停止しようとすると、フックは停止を許可するため、修正できない失敗でループすることはありません（仕組み）。

STOP ゲート（Tier M/L）- 実装前に要件をレビューします。ブロックごとに spec-first または scope-confirm モードが自動選択されます。

プロモーションゲート（Tier S/M/L）- ブロックまたは修正の進行中、ガバナンスゲートは、単独の Promote と返信するまでプロモーションを保留します。このキーワード 1 つにつきプロモーションは 1 回です。staging または main へのプッシュも、プルリクエストのマージ（gh pr merge または GitHub MCP のマージツール）も対象となります。このゲートは Claude が実行するコマンドを読み取るため、REST API 経由のマージなど、検出をすり抜ける形式もあります（詳細）。

監査ログ - ファイルへの書き込みと編集（Tier M/L ではシェルコマンドも）を、使用中のマシンの ~/.claude/audit/<project>.jsonl に追記します（詳細）。

AI の貢献表記 - Claude の支援を受けたコミットすべてに Co-authored-by を付与します。

週次 arch-audit - SessionStart フックが、過去 7 日間に /arch-audit が実行されたか確認します。

CODEOWNERS - .claude/ を変更するプルリクエストでは、テックリードにレビューを依頼します。ブランチ保護またはルールセットで「Require review from Code Owners」が有効になっている場合に限り、レビューが必須になります。GitHub は、すべてのプランでパブリックリポジトリのコードオーナーをサポートし、プライベートリポジトリでは Pro、Team、Enterprise プランのみでサポートします。

---

テスト

node packages/cli/test/integration/run.js    # 1171 integration checks
node --test 'packages/cli/test/unit/**/*.test.js'   # 596 unit tests

対象：tier ごとのファイル構成、Stop フックの有無、パイプラインゲートの数、プレースホルダーの解決、スキルの削減、ネイティブスタックへの適応、ルーブリックのスコアリング、スタック間のコンテンツ不変条件（10 スタック、other フォールバックを除く指定スタック）、ゴールデンファイルのアサーション（Swift、Node-TS、Python）、--answers フィクスチャを使った CLI の全実行。

別の template-coverage レイヤー（packages/cli/test/template-coverage/ 配下）では、スタック間の意味のずれ、ゲート条項の欠落、出荷テンプレート内の未文書化プレースホルダーがある場合、テストを失敗させます。3 つのスクリプト（cross-tier-lint.mjs、gate-enum.mjs、placeholder-check.mjs）は、ローカル作業では単独で実行でき、run.js 内でも自動的に実行されます。戦略とコンセプトレジストリについては、docs/architecture/test-coverage-strategy.mdを参照してください。

---

要件

• Node.js >= 22
• Claude Code CLI
• Git

---

ドキュメント

docs.tierward → marcoguillermaz.github.io/Tierward：クイックスタート、ティア、スキルのリファレンス、設定。

ドキュメント	対象	内容
カスタムスキルガイド	Tierwardを拡張する開発者	SKILL.md形式、フロントマターのスキーマ、作成パターン
運用ガイド	Tierwardを導入するチーム	完全なリファレンス：インストール、ティア、ワークフロー、ガバナンス、FAQ
品質評価基準	ワークスペースを評価するチーム	8次元のスコアリング（D1-D8、0-100%）

---

ロードマップ

12か月の計画については、GitHub Milestonesをご覧ください。

現在：v2.3.0では、新規プロジェクトでコマンドを事前承認しなくなりました。各プロジェクトの.claude/settings.jsonには拒否リストだけが残り、デフォルトモードでは、許可していないコマンドを実行する前にClaude Codeが確認します。initは既存の設定ファイルを上書きしなくなりました。ファイルをバックアップしたうえで、Tierwardのフックと拒否ルールを追加し、許可ルールや確認ルールは追加しません。拒否リストは一般的なすべての強制プッシュ形式を拒否するようになりました。また、ガバナンスゲートはブランチを指定しないプッシュ、--allおよび--mirrorによるプッシュ、ブランチに書き込むGitHub MCPツールも対象とします。監査スキルはサブエージェントの結果を失わずに自らスキャンを実行するようになり、/pr-reviewはメインの会話で実行され、常にレビューをサブエージェントに引き継ぎます。tierward doctorは.pre-commit-config.yamlを解析できない場合に警告するようになり、プラグインのマーケットプレースファイルは、Claude Codeが参照する.claude-plugin/に移動しました。v2.2.0では、git、npx、curlの一律の許可ルールを名前付きコマンドに置き換え、スキルが再びそれぞれの実行結果を待つようにし、テンプレートフックによるデータの読み取り方法を修正しました。これにより、監査ログ、Tier Lの破壊的コマンドチェック、Stopフックのループガードが機能します。v2.1.0では、各プロジェクトが変更をmainに反映する方法（stagingブランチ経由、直接マージ、またはプルリクエストのみ）を選べるようになり、監査モデルのベースラインを現在のClaudeモデルに移行しました。v2.0.1とv2.0.2では、生成されるpre-commit設定を修正し、tierward upgradeがスキャフォールドによって生成されるファイルを上書きしないようにし、ガバナンスゲートが呼び出しで実際に実行されるコマンドを読み取れるようにしました。v2.0.0では、プラットフォーム固有のセキュリティコンテキストファイルを単一の中立的なsecurity.mdに統合しました。これはメジャーバージョンアップの要因となる破壊的変更であり、/repo-hygieneによるクリーンアップ処理も追加しました。

次の予定：上流のAnthropic仕様MCPサーバーが公開されたら、/arch-auditをMCP対応にします。ASTトレースが成熟するか、需要が明らかになった段階で、/privacy-auditを再評価します（Issue #97 サブトラック3）。

---

サポート

Tierwardはオープンソースで、MITライセンスのもと公開開発されています。チームに役立つ場合は、ぜひご支援ください。

• ❤️ GitHubでスポンサーになる：継続的または単発で、開発を支援できます
• ☕ Buy Me a Coffee：アカウント不要の単発支援です
• ⭐ リポジトリにStarを付ける：ほかのプロダクトチームやエンジニアリングチームにプロジェクトを知ってもらう助けになります
• 🐛 Issueを作成するまたはディスカッションを始める
• 🔧 プルリクエストを送る：下記の貢献をご覧ください

---

貢献

開発環境のセットアップ、プロジェクト構成、PRのガイドラインについては、CONTRIBUTING.mdをご覧ください。

セキュリティ上の問題を報告する場合は、SECURITY.mdをご覧ください。

ライセンス

MIT

---

Marco Guillermaz が開発・保守しています。npm では tierward として配布されています。ディスカッションや質問については、GitHub Discussions をご覧ください。