要件(Requirement)から仕様(Specification)、実装、検証までのトレーサビリティを維持した開発支援

version
0.1.0
GitHub stars
8

Install

/plugin install reqord@reqord-plugins

Run it inside Claude Code after adding the marketplace with /plugin marketplace add kicchann/reqord.

Contents

Discovered from source

Skills 8

Scope

  • Do: reqordデータ(spec, req, design.md, SC, feedback, dependencies)を読み集めて全体像を提示する
  • Don't: 実装手段の推奨や実装の実行。判断と実装方法の選択はユーザーに委ねる

コンテキスト一括表示

対象: $ARGUMENTS


Step 0: 引数解析

$ARGUMENTSを解析して表示モードを振り分ける。

$ARGUMENTS パターンモード処理
spec-NNNNNNSpec詳細Step 1a を実行
req-NNNNNNReq概観Step 1b を実行
#N または数値Issue連携Step 1c を実行
空エラー対象ID(spec-id, req-id, issue番号)の指定を求める

Step 1a: Spec詳細モード

以下を並列で読み込む:

グループA(並列実行)

reqord spec show <spec-id> --json
  • .reqord/specifications/<spec-id>/design.md(Readツール)
  • specのrequirementIdから reqord req show <req-id> --json
  • .reqord/requirements/<req-id>/description.md(Readツール)
  • .reqord/context/context.yaml(Readツール)

グループB(グループA完了後)

  • 関連specのdesign.md状況(同じreq-idに紐づく他のspec): reqord spec list --requirement <req-id> --json
  • dependenciesのblockedByに指定されたreqの情報
  • 未解決feedback: reqord feedback list --state open --json からlinkedToが対象spec/reqのもの

表示

## spec-NNNNNN: [specタイトル]

Status: [status] | Req: req-NNNNNN | Priority: [priority] | Complexity: [complexity]

### Success Criteria (req-NNNNNN: [reqタイトル])
1. [ ] [基準1]
2. [ ] [基準2]
3. [ ] [基準3]

### design.md
[design.mdの全文、またはテンプレートのみの場合は「テンプレートのみ(`/reqord:edit <spec-id>` で作成)」]

### 関連Spec
| Spec ID | Title | Status | design.md |
|---------|-------|--------|-----------|
| spec-NNNNNN | ... | implemented | 120行 |

### Dependencies
- blockedBy: [あれば表示、なければ「なし」]

### 未解決Feedback
[あれば表示、なければ「なし」]

### ProjectContext要約
- Tech Stack: [technical.yamlの主要項目]
- Structure: [structure.yamlの主要項目]

### Git操作ガイド
- Branch: `.reqord/settings/setting.yaml` の `branchNaming` 設定の prefix を使用する(例: `<prefix>/spec-NNNNNN-<sanitized-title>`)
- Commit: `feat(<scope>): <summary>` + `Implements spec-NNNNNN (req-NNNNNN: <title>)`
- 詳細: context/resources/git-conventions.md を参照

Step 1b: Req概観モード

以下を並列で読み込む:

reqord req show <req-id> --json
reqord spec list --requirement <req-id> --json
reqord feedback list --state open --json
  • .reqord/requirements/<req-id>/description.md(Readツール)

表示

## req-NNNNNN: [reqタイトル]

Status: [status] | Priority: [priority] | Complexity: [complexity]

### Description
[description.mdの内容]

### Success Criteria
1. [ ] [基準1]
2. [ ] [基準2]

### Specifications
| Spec ID | Title | Status | design.md |
|---------|-------|--------|-----------|
| spec-NNNNNN | ... | approved | 148行 |
| spec-NNNNNN | ... | draft | テンプレート |

### Dependencies
- blockedBy: [あれば表示]
- blocks: [あれば表示]

### 未解決Feedback
[あれば表示、なければ「なし」]

Step 1c: Issue連携モード

gh issue view <issue-number> --json title,body,labels,state,assignees
reqord feedback list --state open --json

feedbackリストからissue番号に一致するエントリを検索。linkedToがあればそのspec/reqの情報も読み込む。

表示

## Issue #N: [issueタイトル]

State: [state] | Labels: [labels]

### Issue本文
[body]

### Reqordリンク
[feedbackエントリがあれば]
- Feedback: [type] / [severity]
- LinkedTo: spec-NNNNNN / req-NNNNNN
- [linkedToのspec/req情報を Step 1a/1b と同様に表示]

[feedbackエントリがなければ]
このissueはreqordにリンクされていません。
リンクするには: /reqord:feedback

エラーハンドリング

reqord CLIが見つからない場合

❌ reqord CLI が見つかりません。
インストール方法: npm install -g @reqord/cli
環境チェック: `/reqord:setup --check`

指定IDが存在しない場合

❌ <id> が見つかりません。
利用可能なIDを確認: /reqord:status

Scope

  • Do: 他スキルが参照する共通データモデル・CLI操作ルール・リファレンス提供
  • Don't: 直接トリガーされることは想定しない(user-invokable: false)。データの変更操作は各専用スキルで実施

Reqord共通知識ベース

このスキルは全reqord系スキル・エージェントの共通基盤。データモデルとCLIルールを定義する。


1. データモデル

Requirement(要件)

  • ID形式: req-NNNNNN(6桁ゼロ埋め)
  • ステータスライフサイクル: draft → approved → implemented → deprecated
    • deprecated への遷移はCLIコマンドで直接実行する。遷移前に必ず /reqord:verify trace <req-id> で影響範囲を確認し、関連specへの影響を把握してからdeprecateすること
  • 主要フィールド:
    • title: 要件タイトル
    • status: 現在のステータス
    • priority: high / medium / low
    • successCriteria: 成功基準のリスト(検証可能な条件)
    • format: user-story(as/iWant/soThat)または EARS
    • dependencies: blockedBy / blocks / relatedTo
    • estimatedComplexity: small / medium / large
    • version: セマンティックバージョン(X.Y形式)
    • versionHistory: バージョン履歴配列(version, status, gitCommit, approvedAt, approvedBy)
    • flags: feedback-review 等のフラグ配列
  • ファイル構成:
    • .reqord/requirements/<req-id>.yaml - メタデータ
    • .reqord/requirements/<req-id>/description.md - 詳細記述

Specification(仕様)

  • ID形式: spec-NNNNNN(6桁ゼロ埋め)
  • ステータスライフサイクル: draft → approved → implemented
    • Specificationにdeprecatedステータスはない。紐づくRequirementがdeprecatedになった場合、関連Specificationは実質的に無効となる
  • 主要フィールド:
    • requirementId: 紐づくreq-id
    • title: 仕様タイトル
    • status: 現在のステータス
    • version: セマンティックバージョン(X.Y形式)
    • versionHistory: バージョン履歴配列
    • flags: フラグ配列
  • ファイル構成:
    • .reqord/specifications/<spec-id>.yaml - メタデータ
    • .reqord/specifications/<spec-id>/design.md - 技術設計書

ProjectContext(プロジェクトコンテキスト)

  • 構成ファイル:
    • .reqord/context/context.yaml - メイン設定(files参照を含む)
    • product.yaml - プロダクトビジョン・スコープ
    • technical.yaml - 技術スタック・アーキテクチャ
    • structure.yaml - コード構造・命名規則
    • domain/*.md - ドメイン固有知識

Feedback(フィードバック)

  • ファイル: .reqord/issues/feedbacks.yaml
  • GitHub Issueと同期。type(bug/improvement/requirement-gap/spec-mismatch/security)、severity、linkedTo で分類
  • reqord feedback sync でGitHub Issueから取り込み

Tasks(タスク)

  • ファイル: .reqord/issues/tasks.yaml
  • Specificationに紐づくGitHub Issueのタスク管理
  • reqord task sync でGitHub Issueから同期

2. YAML直接編集禁止ルール

.reqord/ 配下のYAMLファイルは原則として直接編集してはならない。必ず reqord CLIコマンドを経由すること。

CLIコマンドはバリデーション・バージョン管理・監査証跡を自動で処理する。直接編集はこれらを迂回し、データ不整合の原因となる。

操作→CLIコマンド対応表

操作CLIコマンド直接編集
ステータス変更reqord req approve/draft/implement禁止
バージョンバンプreqord version <id> --patch|--major禁止
フィールド更新(SC等)reqord req update --patch-file禁止
description.md更新reqord req update --description-file禁止
フラグ除去reqord feedback resolve <id> --issue <N>禁止
フィードバック操作reqord feedback link/unlink/close/resolve禁止
Issue同期reqord task sync/sync-all禁止
design.md書き込みWriteツールで直接書き込み許可(CLIコマンドなし)
plugin-config.yaml書き込みWriteツールで直接書き込み許可(プラグイン固有設定、/reqord:setup のみ)

design.mdが直接書き込み可能な理由: design.mdはCLIバリデーション対象外の自由記述ファイルであり、対応するCLIコマンドが存在しない。一方、description.mdは reqord req update --description-file 経由で更新すること(バリデーション・バージョン管理が適用されるため)。

| コンテキスト更新 | reqord context update | 禁止 |

バージョン管理ルール

内容を変更したらバージョンを上げる。

  • --patch(X.Y+1): 内容の修正・改善・追記
  • --major(X+1.0): 破壊的変更・大幅な構造変更
  • コマンド: reqord version <id> --patch --summary "<変更概要>"

3. 提供スキル一覧

スキル用途
/reqord:setup環境セットアップ・前提条件チェック
/reqord:status要件・仕様の実装進捗ダッシュボード
/reqord:newreq/specの新規作成
/reqord:editreq/spec/contextの編集・改善
/reqord:briefspec/req/issueの包括的コンテキスト表示
/reqord:verify実装検証・ステータス更新
/reqord:feedbackフィードバック・バグ報告の処理
/reqord:contextこのスキル。データモデル・CLI・共通知識

プロジェクトのプロセスに応じて、これらを自由に組み合わせて使用する。


4. リファレンス(resources/)

詳細な知見は resources/ ディレクトリを参照。必要に応じて読み込むこと。

ファイル内容読むタイミング
resources/cli-reference.mdCLIコマンド全集・データ読み込み手順CLIコマンドの引数やオプションを確認する時
resources/philosophy.md設計思想・5原則設計判断時、ツールの位置づけを説明する時
resources/quality-framework.mdSMART + EARS + 粒度ルール要件作成・詳細化・バリデーション時
resources/traceability.md三層モデル・依存関係・フラグ影響分析、依存関係設定、フラグ運用時
resources/feedback-workflow.mdフィードバック3段階進化フィードバック処理・リンク時
resources/ai-phases.mdAI支援4フェーズ・HitL境界AI詳細化・設計生成・タスク分解時
resources/anti-patterns.mdアンチパターン・チェックリストレビュー時、品質確認時
resources/git-conventions.mdブランチ命名・コミット・PRテンプレートブランチ作成・コミット・PR作成時(/reqord:brief のGit操作ガイドから参照)
resources/task-workflow.mdタスク定義形式・HTMLタグ・CLIコマンドreqord task create を直接CLI実行する時(専用スキルなし、直接参照)
resources/dialogue-guidelines.md対話設計の原則・テンプレート・アンチパターンAskUserQuestionでヒアリングを行うスキル実装時

Scope

  • Do: req/spec/contextの品質分析・改善案の提示・承認後の適用
  • Don't: 実装コードの変更や検証。コードベース調査が必要な場合はexplorerエージェントを、設計の詳細化が必要な場合はarchitectエージェントを併用すること

ユーザー確認必須: このスキルはreqordデータの変更を伴います。改善案の適用前にユーザーの承認を得てください。

reqord-edit: データ編集・改善

reqordデータを分析し、品質改善案を提示し、承認後に適用する。


引数解析

ユーザー入力: $ARGUMENTS

パターンマッチ:

  • <req-id...> → edit req(SMART品質改善)→ resources/edit-req.md
  • <spec-id...> → edit spec(design.md生成・更新)→ resources/edit-spec.md
  • context → edit context(ProjectContext充実化)→ resources/edit-context.md
  • --all → design.md未記述の全specを対象 → resources/edit-spec.md
  • 空 → AskUserQuestionで対象種別(req / spec / context)を選択してもらい、該当resourcesへ

IDは req-NNNNNN または spec-NNNNNN 形式(/^(spec|req)-\d{6}$/)であることを検証する。複数ID指定はスペースまたはカンマ区切り。形式不正な入力はエラーで拒否。

引数を解析したら、対応するresourcesファイルを読み込んで手順を実行すること。


リファレンス(resources/)

ファイル内容読むタイミング
resources/edit-req.mdRequirement品質改善の手順(SMART分析・改善案提示・適用)edit req 実行時
resources/edit-spec.mddesign.md生成・更新の手順(6セクション構造・分割判断)edit spec 実行時
resources/edit-context.mdProjectContext充実化の手順(参照ファイル作成・更新)edit context 実行時

エラーハンドリング

ID が見つからない場合

<id> が見つかりません。
新規作成する場合は `/reqord:new req` または `/reqord:new spec` を使用してください。
既存IDの確認は `reqord req list` / `reqord spec list` で実行できます。

reqord CLIが利用不可の場合

❌ reqord CLIが見つかりません。
インストール方法: npm install -g @reqord/cli
環境確認は `/reqord:setup --check` で実行できます。

直接ファイル読み取りによるフォールバックは行わない。

ユーザー確認必須: このスキルはGitHub Issue操作(クローズ・コメント)を伴います。自律実行時は操作内容をユーザーに提示し、承認を得てから実行してください。

Scope

  • Do: フィードバックの作成・同期・分類・リンク・クローズ・フラグ解消を実行する
  • Don't: リンク先req/specの内容修正や実装。修正は別途実施する

Feedback運用コマンド

対象: $ARGUMENTS


引数解析

$ARGUMENTSモード処理
create新規作成resources/create.md に従い GitHub Issue を作成
issue番号(スペース区切りで複数可)取り込みStep 1〜7 を実行
空未処理一覧Step 1〜7 を実行(Step 2 で対象選択)

Step 1: 同期

reqord feedback sync

Step 1.5: リポジトリ確認

GitHub操作前に対象リポジトリを確認する:

git remote -v

想定と異なるリポジトリの場合はユーザーに確認を取る。


Step 2: 対象フィードバックの特定

入力バリデーション

issue番号は正の整数のみ受け付ける(/^#?\d+$/)。# 接頭辞は任意。形式不正な入力はエラー表示してスキップ。

$ARGUMENTSが空の場合

  1. reqord feedback list --state open --json で未処理一覧を取得
  2. テーブル形式で表示:
| # | Issue | Type | Severity | LinkedTo | Status |
|---|-------|------|----------|----------|--------|
| 1 | #208 | bug | medium | spec-000011 | open |
| 2 | #209 | requirement-gap | medium | req-000011 | open |
  1. AskUserQuestionで対象を選択してもらう(複数選択可、「全件処理」オプションも提示)

$ARGUMENTSが指定されている場合

スペース区切りで複数issue番号を受け付ける。存在しないものはエラー表示してスキップ。


Step 3: 内容確認

対象フィードバックごとに reqord feedback show <issue-number> --json を並列実行し、内容を確認する。

表示内容: GitHub Issue のタイトル・本文、現在の type / severity / linkedTo / status


Step 4: 分類・リンク判断

resources/classify-and-link.md のルールに従い、各フィードバックの Type とリンク先を判定する。

対象フィードバックごとに提示:

### #208: [Issueタイトル]
- 推奨 Type: bug
- 推奨リンク先: --spec spec-000011
- 判断理由: [Issueの内容から読み取った根拠]

AskUserQuestionで各フィードバックの Type・リンク先を確認する。


Step 5: リンク実行

ユーザー承認後、各フィードバックに対して reqord feedback link を実行する:

# spec にリンクする場合
reqord feedback link <issue-number> --type <type> --severity <severity> --spec <spec-id>

# 既存 req にリンクする場合
reqord feedback link <issue-number> --type <type> --severity <severity> --req <req-id>

# 新規 req を作成してリンクする場合
reqord feedback link <issue-number> --type <type> --severity <severity> --created-req

既にリンク済みのフィードバック(linkedTo に値がある)はスキップし、報告のみ行う。

注意: 1つのフィードバックが複数のreq/specに影響する場合は、影響を受けるすべてに対してリンクを実行する(複数回実行)。影響範囲の漏れを防ぐため、req/specの description やコードベースを確認すること。


Step 6: クローズ処理

クローズ判断

  • クローズ可能: type/severity が設定済み、かつリンク先が設定済み
  • クローズ不可: リンクが未完了、または追加対応が必要

Flag ライフサイクルの注意事項

重要: feedback close と flag 解消は独立した概念。

feedback close = フィードバックの取り込み完了(分類・リンク済み)
               ≠ flag 解消(req/spec の修正完了)

flag のライフサイクル:
  作成 → feedback link 時に req/spec へ自動付与
  解消 → req/spec の修正完了後に `reqord feedback resolve` で除去

.reqord/settings/setting.yaml の feedbackValidation 設定により、flag 残存時の動作が決まる:

  • blockOnUnresolved: true の場合、severityThreshold 以上の severity の flag が残存していると /reqord:verify done がブロックされる
  • blockOnUnresolved: false(デフォルト)の場合、flag 残存は警告のみで完了処理を妨げない

クローズ実行

reqord feedback close <issue-number>

Step 7: 結果確認・修正フロー案内

処理結果サマリー

| Issue | Type | Severity | リンク先 | Status |
|-------|------|----------|----------|--------|
| #208 | bug | medium | spec-000011 | closed |
| #209 | requirement-gap | medium | req-000011 | closed |

残存確認

reqord feedback list --state open

Flag 残存の注意喚起

クローズしたフィードバックに関連する req/spec の flag を確認し、未解消の flag がある場合は報告:

以下の req/spec に feedback-review flag が残っています(修正完了後に解消が必要):
- req-000011: feedback-review (from #209)
- spec-000011: feedback-review (from #208)

修正方法:
- 要件の修正: `/reqord:edit <req-id>`
- 仕様の修正: `/reqord:edit <spec-id>`

修正完了後のflag解消は resources/resolve.md の手順、または以下を実行:
  reqord feedback resolve <artifact-id> --issue <issue-number>

修正フロー案内

flag付与後の修正→再検証フロー:

1. 修正内容確認・設計更新: /reqord:edit <spec-id|req-id>
2. 実装コンテキスト確認:   /reqord:brief <spec-id>
3. 修正実装
4. flag解消:              reqord feedback resolve <artifact-id> --issue <issue-number>
5. 再検証:                /reqord:verify done <spec-id>

リファレンス(resources/)

ファイル内容読むタイミング
resources/create.mdフィードバック新規作成手順create サブコマンド実行時
resources/classify-and-link.mdType判定・リンク先決定ルールStep 4 の分類判断時
resources/resolve.mdFlag解消手順修正完了後のflag除去時

エラーハンドリング

reqord CLIが見つからない場合

❌ reqord CLI が見つかりません。
インストール方法: npm install -g @reqord/cli
環境チェック: `/reqord:setup --check`

gh CLIが未認証の場合

⚠ gh CLI が未認証です。GitHub Issue操作にはgh auth loginが必要です。

Scope

  • Do: req/specの新規作成、description.mdの初期記述、design.mdの初期テンプレート生成、ステータス遷移(approve)
  • Don't: 既存データの編集・改善(/reqord:edit を使用)。design.mdの詳細記述(/reqord:edit <spec-id> で実施)

ユーザー確認必須: このスキルはreqordデータの作成・ステータス変更を伴います。作成前にユーザーの承認を得てください。

reqord-new: データ新規作成

reqordデータを対話的に新規作成する。


引数解析

ユーザー入力: $ARGUMENTS

パターンマッチ:

  • req → new req(Requirement新規作成)→ resources/new-req.md
  • spec <req-id> → new spec(Specification新規作成)→ resources/new-spec.md
  • spec (req-id省略)→ AskUserQuestionで紐づけ先reqを選択 → resources/new-spec.md
  • 空 → AskUserQuestionで種別(req / spec)を選択
  • 上記以外 → エラー: 使い方: /reqord:new <req|spec> [req-id]

引数を解析したら、対応するresourcesファイルを読み込んで手順を実行すること。


リファレンス(resources/)

ファイル内容読むタイミング
resources/new-req.mdRequirement新規作成の手順new req 実行時
resources/new-spec.mdSpecification新規作成の手順new spec 実行時

エラーハンドリング

reqord CLIが利用不可の場合

❌ reqord CLIが見つかりません。
インストール方法: npm install -g @reqord/cli
環境確認は `/reqord:setup --check` で実行できます。

直接ファイル読み取りによるフォールバックは行わない。

Scope

  • Do: CLIツール・GitHub認証・プロジェクト初期化状態の確認、証憑記録
  • Don't: ツールのインストール実行(インストール手順の案内のみ)。reqordデータの変更は行わない

ユーザー確認必須: このスキルは環境設定の変更を伴います。自律実行時はセットアップ内容をユーザーに提示し、承認を得てから実行してください。

Reqordプラグイン環境セットアップ

モード: $ARGUMENTS(デフォルト: フルセットアップ)

プラグインの動作に必要な環境を確認し、未セットアップの項目があればガイドする。 完了後、.reqord/settings/plugin-config.yaml にセットアップ証憑を記録する。


引数解析

$ARGUMENTSモード処理
空フルセットアップStep 1〜6を順に実行
--check確認のみStep 1〜4を実行し結果表示のみ(証憑更新なし)

Step 1: 必須ツールの可用性チェック

以下のコマンドを並列実行し、各ツールの可用性を確認する:

reqord --version        # Reqord CLI
gh --version            # GitHub CLI
git --version           # Git

判定基準

ツール必須度用途不在時の影響
reqord CLI必須全スキルのデータ操作フォールバック可(直接ファイル読み取り)だが非推奨
gh CLI強く推奨feedback sync、issue検索、PR作成/reqord:feedback が使用不可
git必須ブランチ操作、コミット、履歴検索/reqord:verify trace が使用不可

結果表示

## 環境チェック結果

| ツール | Status | Version |
|--------|--------|---------|
| reqord | ✅ | v0.5.0 |
| gh     | ✅ | 2.45.0 |
| git    | ✅ | 2.43.0 |

reqord CLI が見つからない場合:

❌ reqord CLI が見つかりません。
インストール方法: npm install -g @reqord/cli

gh CLI が見つからない場合:

⚠ gh CLI が見つかりません。
以下の機能が制限されます:
- /reqord:feedback(GitHub Issue同期)
- PR作成(gh pr create)
- /reqord:verify trace(PR検索)

インストール: https://cli.github.com/

Step 2: GitHub CLI 認証チェック

gh CLI が存在する場合、認証状態を確認する:

gh auth status

認証済みの場合

✅ GitHub認証: <username> (<hostname>)

未認証の場合

⚠ GitHub CLIが未認証です。
`gh auth login` を実行して認証してください。

認証なしでも以下は使用可能です:
- /reqord:status, /reqord:edit, /reqord:brief, /reqord:verify validate

Step 3: Reqordプロジェクト初期化チェック

.reqord/ ディレクトリの存在と構造を確認する:

確認項目

Readツール / Globツールで以下を確認:

パス必須度用途
.reqord/必須プロジェクトルート
.reqord/context/context.yaml必須ProjectContext
.reqord/requirements/必須要件データ
.reqord/specifications/必須仕様データ
.reqord/feedback/推奨フィードバックデータ
.reqord/settings/推奨設定

未初期化の場合

❌ .reqord/ ディレクトリが見つかりません。
このプロジェクトはReqordで初期化されていません。

`reqord init` を実行してプロジェクトを初期化してください。

部分的に存在する場合

不足しているディレクトリ・ファイルを報告し、reqord init または手動作成を案内する。


Step 4: ProjectContext読み込みチェック

.reqord/context/context.yaml が存在する場合、files フィールドが参照するファイルの存在を確認する:

reqord context show --json

または直接Readツールで .reqord/context/context.yaml を読み取る。

確認項目

参照先必須度影響するスキル
files.product (product.yaml)推奨edit, brief, new
files.technical (technical.yaml)強く推奨edit, brief, verify(テストコマンド特定に使用)
files.structure (structure.yaml)推奨edit, brief(命名規則・構造ルール)
files.domain (domain/*.md)任意edit(ドメイン知識)

未設定のファイルがある場合

⚠ ProjectContextの以下のファイルが未設定/未作成です:
- technical.yaml: 未作成(/reqord:edit, /reqord:brief のテスト・ビルドコマンド特定に影響)
- domain/*.md: 未設定(任意)

`reqord context update` でProjectContextを更新できます。

Step 5: セットアップ結果サマリー

全チェック結果を集約して表示する:

## Reqordプラグイン セットアップ結果

### 環境
| 項目 | Status |
|------|--------|
| reqord CLI | ✅ v0.5.0 |
| gh CLI | ✅ 2.45.0 (認証済み: username) |
| git | ✅ 2.43.0 |

### プロジェクト
| 項目 | Status |
|------|--------|
| .reqord/ | ✅ 初期化済み |
| context.yaml | ✅ |
| product.yaml | ✅ |
| technical.yaml | ✅ |
| structure.yaml | ⚠ 未作成 |
| domain/*.md | - (任意) |


Step 6: 証憑記録

--check モードでない場合、セットアップ結果を .reqord/settings/plugin-config.yaml に記録する。

記録内容

plugin:
  name: reqord
  setupCompletedAt: "2026-02-17T10:30:00+09:00"
  setupVersion: "0.1.0"
environment:
  reqord:
    available: true
    version: "0.5.0"
  gh:
    available: true
    version: "2.45.0"
    authenticated: true
    user: "username"
  git:
    available: true
    version: "2.43.0"
project:
  initialized: true
  context:
    product: true
    technical: true
    structure: false
    domain: []

書き込み手順

  1. .reqord/settings/ ディレクトリの存在を確認(なければ報告)
  2. 既存の plugin-config.yaml があればReadツールで読み取り
  3. Writeツールで新しい内容を書き込み

セットアップ完了メッセージ

✅ セットアップが完了しました。証憑を .reqord/settings/plugin-config.yaml に記録しました。

エラーハンドリング

.reqord/settings/ ディレクトリが存在しない場合

⚠ .reqord/settings/ ディレクトリが存在しません。
証憑の記録をスキップします。
`reqord init` でプロジェクトを再初期化するか、手動でディレクトリを作成してください。

必須ツールが全て不在の場合

❌ 必須ツール(reqord CLI, git)が見つかりません。
プラグインの機能を使用するには、少なくとも以下のインストールが必要です:

1. reqord CLI: npm install -g @reqord/cli
2. git: https://git-scm.com/

セットアップを中止します。

Scope

  • Do: reqordデータを集計し、進捗状況・準備状況を事実として表示する
  • Don't: 着手順序の推奨や実装判断。判断はユーザーに委ねる

Reqord進捗ダッシュボード

フィルタ: $ARGUMENTS(デフォルト: approved = 実装待ち)


Step 1: データ取得

以下を並列実行:

reqord req list --json
reqord spec list --json
reqord feedback list --state open --json

Step 2: ステータス別集計テーブル

取得データからステータス別の集計テーブルを生成する。

Requirements

| Status | Count | IDs |
|--------|-------|-----|
| draft | 2 | req-000001, req-000002 |
| approved | 3 | req-000003, req-000004, req-000005 |
| implemented | 5 | req-000006, ... |
| deprecated | 0 | - |
| Total | 10 | |

Specifications

| Status | Count | IDs |
|--------|-------|-----|
| draft | 1 | spec-000001 |
| approved | 4 | spec-000002, spec-000003, ... |
| implemented | 3 | spec-000004, ... |
| Total | 8 | |

Step 3: フィルタに応じた詳細表示

$ARGUMENTSに基づいて詳細表示する対象を決定する。

$ARGUMENTS表示対象説明
空 / approvedstatus=approved のspec実装待ち
implementedstatus=implemented のspec実装済み
all全spec全件表示

フィルタ対象のspecについて、以下のテーブルを表示する:

| Spec ID | Req ID | Title | Priority | Complexity | design.md | Flags |
|---------|--------|-------|----------|------------|-----------|-------|
| spec-000003 | req-000003 | CLI仕様表示 | high | small | 148行 | - |
| spec-000005 | req-000005 | バージョン管理 | medium | medium | テンプレート | - |
| spec-000007 | req-000007 | Web画面 | low | large | 253行 | feedback-review |

design.md列: .reqord/settings/setting.yaml の approvalPrerequisites.designMdCheck を確認する。true(デフォルト)の場合、各specのdesign.mdを読み取り行数を表示する。「Specification Design Template」のみ、「Phase 3で実装予定」のみ、または10行以下の場合は「テンプレート」と表示。false の場合、design.md列は - と表示する(チェック不要のため)。


Step 4: 未解決Feedback Flagの表示

Step 1で取得したfeedback一覧から、openかつlinkedToが設定されているものを抽出する。

未解決flagがある場合:

### 未解決Feedback Flags

| Issue | Type | Severity | LinkedTo | Title |
|-------|------|----------|----------|-------|
| #208 | bug | medium | spec-000011 | エラーメッセージが不明瞭 |
| #209 | requirement-gap | medium | req-000011 | 一括操作機能が未定義 |

Step 5: 準備状況サマリー

フィルタがapprovedの場合、各specの準備状況を分類して表示する:

### 準備状況

| Status | Spec IDs | 説明 |
|--------|----------|------|
| Ready | spec-000003 (high/small) | design.md記述済み(designMdCheck有効時)、ブロッカーなし |
| Needs design | spec-000005 (medium/medium) | design.mdがテンプレートのまま(designMdCheck有効時のみ表示) |
| Blocked | spec-000008 (high/medium) | blockedBy: spec-000003 |
| Feedback pending | spec-000007 (low/large) | feedback-review flagあり |

依存関係チェック: 各specに紐づくrequirementのdependencies(blockedBy)を確認し、ブロッカーがある場合はテーブルに反映する。


エラーハンドリング

reqord CLIが見つからない場合

❌ reqord CLIが見つかりません。
インストール: npm install -g @reqord/cli
環境チェック: `/reqord:setup --check`

Scope

  • Do: req/spec/contextの整合性検証、specの実装充足チェック、トレーサビリティ可視化、完了処理
  • Don't: 検証で見つかった問題の修正や改善提案。報告に徹し、修正はユーザーの判断に委ねる

ユーザー確認必須: doneサブコマンドはSpecificationステータスを変更します。自律実行時はステータス変更前にユーザーの承認を得てください。

reqord-verify: データ検証・実装確認

reqordデータの整合性・品質を検証し、実装充足を確認し、トレーサビリティを可視化する。


引数解析

ユーザー入力: $ARGUMENTS

パターンマッチ:

  • validate <spec-id> → validate spec(実装充足チェック)→ resources/validate.md
  • validate <req-id> → validate req(SMART品質チェック)→ resources/validate.md
  • validate context → validate context(参照整合性チェック)→ resources/validate.md
  • validate all → validate all(全データ一括チェック)→ resources/validate.md
  • trace <req-id|spec-id> → trace(トレーサビリティ可視化)→ resources/trace.md
  • done <spec-id> → done(検証+完了処理)→ resources/done.md
  • 上記以外 → エラー: 使い方: /reqord:verify <validate|trace|done> <spec-id|req-id|context|all>

IDは spec-NNNNNN または req-NNNNNN 形式(/^(spec|req)-\d{6}$/)であることを検証する。形式不正な入力はエラーで拒否。

引数を解析したら、対応するresourcesファイルを読み込んで手順を実行すること。


リファレンス(resources/)

ファイル内容読むタイミング
resources/validate.mdvalidate req/spec/context/all の手順validateサブコマンド実行時
resources/trace.mdトレーサビリティ可視化の手順traceサブコマンド実行時
resources/done.md検証+完了処理+Time to Learning+振り返りの手順doneサブコマンド実行時
resources/validate-criteria.mdSuccess Criteria判定ロジック・コンポーネント確認パターンvalidate specのStep 4で判定基準を確認する時

エラーハンドリング

spec-id/req-idが見つからない場合

❌ <id> が見つかりません。
`reqord spec list` / `reqord req list` で有効なIDを確認してください。

reqord CLIが利用不可の場合

❌ reqord CLIが見つかりません。
インストール方法: npm install -g @reqord/cli
環境確認は `/reqord:setup --check` で実行できます。

直接ファイル読み取りによるフォールバックは行わない。

テスト実行失敗時

WARNING: テスト実行に失敗しました。テストカバレッジの確認をスキップします。
テストコマンドを手動で実行して問題を確認してください。

検証レポートのテストセクションには「確認不可」と表示する。

Agents 3

Scope

  • Do: design.mdを入力とし、technical.yaml/structure.yamlの設計原則に従った実装計画を生成する。Success Criteriaを検証可能な設計に落とし込む
  • Don't: 汎用的なアーキテクチャ設計(Clean Architecture原則の詳細適用、テスタビリティ設計等)。それらが必要な場合はプロジェクトに導入されているcode-architectエージェントや関連スキルを併用すること

You are a senior software architect with deep knowledge of Reqord's requirements-driven development workflow.

Reqord固有の設計フロー

1. design.mdを入力として受け取る

.reqord/specifications/<spec-id>/design.md の6セクション構造を読み取り、設計の出発点とする:

  • Overview / Scope
  • Component Design
  • Data Flow
  • Test Strategy
  • Success Criteria
  • Notes / Constraints

2. ProjectContextの設計原則に従う

  • technical.yaml: 技術スタック・アーキテクチャルール
  • structure.yaml: コード構造・命名規則・ディレクトリ配置
  • これらに違反する設計を行わない

3. Success Criteriaを検証可能な設計に落とし込む

各success criterionに対して:

  • どのコンポーネントが責任を持つか
  • どのテストで検証するか
  • 検証方法(output-based / state-based / communication-based)

Output Guidance

Deliver a decisive, complete architecture blueprint. Include:

  • Architecture Decision: Chosen approach with rationale and trade-offs
  • Component Design: Each component with file path, responsibilities, dependencies, and interfaces
  • Implementation Map: Specific files to create/modify with detailed change descriptions
  • Build Sequence: Phased implementation steps as a checklist (TDD-ready decomposition)
  • Success Criteria Mapping: Each criterion mapped to components and test strategy

Make confident architectural choices rather than presenting multiple options. Be specific and actionable - provide file paths, function names, and concrete steps.

Scope

  • Do: Reqordの要件・仕様(req/spec/design.md)を踏まえたコードベース調査。design.mdのコンポーネント構成と実コードの照合、Success Criteria実装状況の分析
  • Don't: 汎用的なコードベース探索(パターン分析、依存関係マッピング等)。それらが必要な場合はプロジェクトに導入されているcode-explorerエージェントを併用すること

You are an expert code analyst specializing in tracing and understanding feature implementations, with deep knowledge of Reqord's requirements-driven development workflow.

Reqord固有の調査フロー

spec-id / req-id が指定された場合

  1. 要件・仕様の取得: reqord spec show <spec-id> --json / reqord req show <req-id> --json で情報を取得(CLIが使えない場合は直接ファイル読み取りにフォールバック)
  2. design.mdの読み取り: .reqord/specifications/<spec-id>/design.md を読み、コンポーネント構成・テスト方針を把握
  3. 実コードの存在確認: design.mdに記載された各コンポーネントについて、Glob/Grepで対応する実コードが存在するか確認
  4. Success Criteriaの実装状況: 各success criterionに対応する実装・テストの有無を報告

structure.yamlに基づくパターン分析

.reqord/context/structure.yaml の命名規則・ディレクトリ構成ルールに照らし合わせ、コードがプロジェクト規約に準拠しているか確認する。

Output Guidance

Provide a comprehensive analysis including:

  • Entry points with file:line references
  • Key components and their responsibilities
  • Success Criteria実装状況: 各criterionに対する実装の有無と対応コード箇所
  • design.mdとの差分: 設計と実装の不一致がある場合は明示
  • List of files that are essential to understanding the topic

Structure your response for maximum clarity and usefulness. Always include specific file paths and line numbers.

Scope

  • Do: Success criteriaに対する実装の網羅性チェック、design.mdとの一致確認、structure.yaml準拠、トレーサビリティ検証
  • Don't: 汎用的なコードレビュー(バグ検出、コード品質、テスト品質評価等)。それらが必要な場合はプロジェクトに導入されているcode-reviewerエージェントや関連スキルを併用すること

You are an expert code reviewer with deep knowledge of Reqord's requirements-driven development workflow. Your primary responsibility is to review code against reqord specifications with high precision to minimize false positives.

Reqord固有のレビュー観点

1. Success Criteria網羅性

各success criterionに対して:

  • 対応する実装コードが存在するか(file:line参照)
  • 対応するテストが存在するか(file:line参照)
  • テストが criterion の検証として十分か

2. design.md一致性

  • コンポーネント構成がdesign.mdの設計と一致しているか
  • データフローがdesign.mdの記述と一致しているか
  • テスト方針がdesign.mdのTest Strategyに従っているか

3. structure.yaml準拠

  • 命名規則(files/dirs: kebab-case, classes/types: PascalCase, etc.)への準拠
  • ディレクトリ配置ルールへの準拠
  • アーキテクチャルール(依存方向、レイヤー分離)への準拠

4. トレーサビリティ

  • コミットメッセージにspec-id/req-id参照があるか
  • PR本文にSuccess Criteriaチェックリストがあるか
  • ブランチ名が <prefix>/spec-NNNNNN-* 形式か(prefixは .reqord/settings/setting.yaml の branchNaming 設定に従う)

Review Scope

By default, review unstaged changes from git diff. The user may specify different files or scope to review.

Output Guidance

Start by clearly stating what you're reviewing. For each high-confidence issue, provide:

  • Clear description with confidence score
  • File path and line number
  • Concrete fix suggestion

Group issues by severity:

  1. Critical: Success criteria gaps, design.md violations
  2. Important: structure.yaml violations, traceability gaps

If no high-confidence issues exist, confirm the code meets standards with a brief summary including success criteria coverage status.

Sponsors

Details

Marketplace
kicchann/reqord
Source
plugins/reqord
Author
kicchann
Category
Development