# NexusArchitect Docs

> Claude Codeプラグイン「NexusArchitect」の全体像・導入方法・各スキルの体系的なドキュメント。

## Docs

- [NexusArchitectとは](https://nexus-architect-docs-070772.gitlab.io/): Claude Code上で動くツール、NexusArchitectが何をしてくれるかの全体像
- [トラブルシューティング](https://nexus-architect-docs-070772.gitlab.io/troubleshooting): 実際に踏んだ問題を症状ごとにまとめたページ。ラベル操作の書式ミス、PR/MRが見つからない、スキルが実行できない、Epicが作られない、中断からの再開
- [用語集](https://nexus-architect-docs-070772.gitlab.io/glossary): このドキュメントに出てくる用語の一覧。企画・バックログ・実装レビュー・基盤・仕組みの5群に分けて並べています
- [更新情報](https://nexus-architect-docs-070772.gitlab.io/changelog): NexusArchitectのリリース履歴。全バージョンの概要と公式リリースノートへのリンク
- [関連リンク](https://nexus-architect-docs-070772.gitlab.io/resources): NexusArchitectのサンプル実装や、実際に使ってみた人による連載記事・書籍などの外部リンク集

## はじめに

- [導入方法](https://nexus-architect-docs-070772.gitlab.io/getting-started/installation): NexusArchitectプラグインのインストール方法と、使えるようになるコマンド、disable-model-invocationという制限について説明します
- [前提条件](https://nexus-architect-docs-070772.gitlab.io/getting-started/prerequisites): NexusArchitectを使う前に必要な準備(Gitリポジトリ、Issueトラッカーの認証、GitLab Epic機能に関する条件)をまとめます
- [クイックスタート](https://nexus-architect-docs-070772.gitlab.io/getting-started/first-run): インストール後に打つコマンドを、企画からマージまで順番どおりに並べた手順
- [出力ディレクトリ構造](https://nexus-architect-docs-070772.gitlab.io/getting-started/output-structure): NexusArchitectが使うreports/とwork/のディレクトリ構造、フォルダ・ファイルそれぞれの役割について詳しく説明します

## 基本の仕組み

- [基本の仕組み](https://nexus-architect-docs-070772.gitlab.io/concepts): NexusArchitectを支える横断的な仕組みの一覧
- [パイプライン依存関係グラフ](https://nexus-architect-docs-070772.gitlab.io/concepts/dependency-graph): skill-dependencies.yamlによるフェーズの実行順序とプロファイル
- [検証ゲート](https://nexus-architect-docs-070772.gitlab.io/concepts/validation-gate): /product:validate-assumptionsで、次に進んでよいかどうかを判断する仕組み
- [ライブダッシュボード](https://nexus-architect-docs-070772.gitlab.io/concepts/live-dashboard): パイプラインの進捗・検証ゲートの判定・コストをターミナル上でリアルタイムに確認できる仕組み
- [Shared-Contextパック](https://nexus-architect-docs-070772.gitlab.io/concepts/shared-context): architect:implement-backlogが構築する共有知識パックの構成
- [ステータスラベルの状態機械](https://nexus-architect-docs-070772.gitlab.io/concepts/status-labels): todo→doing→review→doneの順にラベルが変わる仕組みと、誰が変えていいかのルール
- [チェックリストの三重構造](https://nexus-architect-docs-070772.gitlab.io/concepts/checklist-contract): 子タスクリスト・受入基準・Delivery Statusの3種類と、それぞれのチェック権限
- [中断と再開](https://nexus-architect-docs-070772.gitlab.io/concepts/resume): 途中で止まった作業をどこから再開できるのか、進捗はどのファイルに記録されているのか
- [トークンコストの考え方](https://nexus-architect-docs-070772.gitlab.io/concepts/token-cost): 何がコストを決めるのか、実際にかかった額をどう確認するのか、事前に見積もるコマンド

## スキル詳細

- [Productパイプライン](https://nexus-architect-docs-070772.gitlab.io/skills/product-pipeline): /product:* にある全スキルの一覧と、各スキルが発行する追跡用ID(トレーサビリティID)
- [Architectパイプライン](https://nexus-architect-docs-070772.gitlab.io/skills/architect-pipeline): /architect:* の新規開発(グリーンフィールド)/既存改修(レガシー)の2つの進め方と、品質チェック・レビュー系スキルの一覧
- [Infraプラグイン](https://nexus-architect-docs-070772.gitlab.io/skills/infra): /infra:* の4スキル(start/design/implement/review)と、architectパイプラインとの境界線

### バックログ運用

- [export-backlog](https://nexus-architect-docs-070772.gitlab.io/skills/backlog/export): reports/の内容をもとに、Epic・Sub-Epic・Issueを作成するスキルの説明
- [implement-backlog](https://nexus-architect-docs-070772.gitlab.io/skills/backlog/implement): サブエージェント(役割ごとの小さなAI)を難しさに応じて使い分けながら、実装を進めるスキルの説明
- [review-issue](https://nexus-architect-docs-070772.gitlab.io/skills/backlog/review): Epic全体を見て行うレビューと、自動で直す仕組み(自動修正ループ)、review-knowledge.mdへの知識のまとめ方
- [merge-issue](https://nexus-architect-docs-070772.gitlab.io/skills/backlog/merge): マージ前の事前確認(プリフライトチェック)と、完了後に自動で進む更新処理(ロールアップ)の連鎖

## 実践例: EASE

- [実践例: EASE](https://nexus-architect-docs-070772.gitlab.io/tutorial): 商談・案件管理SaaS「EASE」を企画からマージまで通して動かした実行記録。何が起きたかのケーススタディ

## English

### Docs

- [What is NexusArchitect](https://nexus-architect-docs-070772.gitlab.io/en): An overview of what NexusArchitect, a tool that runs on Claude Code, does for you
- [Changelog](https://nexus-architect-docs-070772.gitlab.io/en/changelog): NexusArchitect release history. Summary of all versions with links to official release notes
- [Glossary](https://nexus-architect-docs-070772.gitlab.io/en/glossary): A list of terms that appear in this documentation, grouped into five areas — product, backlog, implementation/review, infrastructure, and mechanics.
- [Related Links](https://nexus-architect-docs-070772.gitlab.io/en/resources): A curated set of external links — a sample implementation, a talk, and write-ups and books by people who have used NexusArchitect
- [Troubleshooting](https://nexus-architect-docs-070772.gitlab.io/en/troubleshooting): A page of real issues organized by symptom — label operation formatting mistakes, PR/MR not found, skill cannot execute, Epic not created, resuming from interruption

### Getting Started

- [Installation](https://nexus-architect-docs-070772.gitlab.io/en/getting-started/installation): How to install the NexusArchitect plugin, the commands it provides, and the disable-model-invocation restriction
- [Prerequisites](https://nexus-architect-docs-070772.gitlab.io/en/getting-started/prerequisites): Summarizes the prerequisites required before using NexusArchitect (Git repository, Issue tracker authentication, and conditions related to the GitLab Epic feature)
- [Quick Start](https://nexus-architect-docs-070772.gitlab.io/en/getting-started/first-run): Commands to run after installation, ordered from planning to merge
- [Output Directory Structure](https://nexus-architect-docs-070772.gitlab.io/en/getting-started/output-structure): Describes the reports/ and work/ directory structure used by NexusArchitect, and the role of every folder and file in detail

### How It Works

- [How It Works](https://nexus-architect-docs-070772.gitlab.io/en/concepts): An overview of the cross-cutting mechanisms that underpin NexusArchitect
- [Pipeline Dependency Graph](https://nexus-architect-docs-070772.gitlab.io/en/concepts/dependency-graph): Phase execution order and profiles via skill-dependencies.yaml
- [Validation Gate](https://nexus-architect-docs-070772.gitlab.io/en/concepts/validation-gate): How /product:validate-assumptions determines whether it is safe to proceed
- [Live Dashboard](https://nexus-architect-docs-070772.gitlab.io/en/concepts/live-dashboard): Monitor pipeline progress, validation gate verdicts, and costs in real time directly in your terminal
- [Shared-Context Pack](https://nexus-architect-docs-070772.gitlab.io/en/concepts/shared-context): Structure of the shared-knowledge pack built by architect:implement-backlog
- [Status Label State Machine](https://nexus-architect-docs-070772.gitlab.io/en/concepts/status-labels): How labels transition in todo→doing→review→done order, and the rules for who can change them
- [Three-Tier Checklist Structure](https://nexus-architect-docs-070772.gitlab.io/en/concepts/checklist-contract): The three checklist types — child task list, acceptance criteria, and Delivery Status — and which skills have the authority to check each
- [Interruption and Resumption](https://nexus-architect-docs-070772.gitlab.io/en/concepts/resume): Where you can resume interrupted work and which files record progress
- [Understanding Token Costs](https://nexus-architect-docs-070772.gitlab.io/en/concepts/token-cost): What determines cost, how to check what you actually spent, and a command to estimate in advance

### Skill Details

- [Product Pipeline](https://nexus-architect-docs-070772.gitlab.io/en/skills/product-pipeline): A list of all skills under /product:*, and the traceability IDs each skill issues
- [Architect Pipeline](https://nexus-architect-docs-070772.gitlab.io/en/skills/architect-pipeline): The two approaches for /architect:* — greenfield (new development) and legacy (existing system rework) — plus a reference list of quality-check and review skills
- [Infra Plugin](https://nexus-architect-docs-070772.gitlab.io/en/skills/infra): The four /infra:* skills (start/design/implement/review), and the boundary with the architect pipeline

#### Backlog Management

- [export-backlog](https://nexus-architect-docs-070772.gitlab.io/en/skills/backlog/export): Skill that creates Epics, Sub-Epics, and Issues from the contents of reports/
- [implement-backlog](https://nexus-architect-docs-070772.gitlab.io/en/skills/backlog/implement): Description of the skill that drives implementation by routing work to sub-agents sized for each role, selecting the AI model based on task difficulty
- [review-issue](https://nexus-architect-docs-070772.gitlab.io/en/skills/backlog/review): Epic-wide review, the auto-fix loop, and how to distill findings into review-knowledge.md
- [merge-issue](https://nexus-architect-docs-070772.gitlab.io/en/skills/backlog/merge): Preflight checks before merging and the automatic rollup chain that runs after a successful merge

### Tutorial: EASE

- [Tutorial: EASE](https://nexus-architect-docs-070772.gitlab.io/en/tutorial): An execution record of running NexusArchitect's backlog workflow end-to-end — from planning to merge — using the deal and pipeline management SaaS "EASE". A case study of what happened.