Communityコーディング&開発github.com

juliusbrussee/spec

リポジトリルートのSPEC.mdを作成、修正、またはバグをバックプロパゲーションします。プロジェクト仕様の唯一の変更権限を持つスキルです。

spec とは?

このスキルは、リポジトリルートにあるSPEC.mdファイルを操作するための専用エージェントです。ユーザーが「仕様を書いて」「新しいスペック」「既存コードから仕様を抽出」「§V.3を修正」「バグ:...」などのフレーズを使用すると自動的にトリガーされ、仕様の新規作成、セクション(§G, §C, §I, §V, §T, §B)の修正、不変条件の追加、コードからの仕様抽出、バグのバックプロパゲーション(逆伝搬)を実行します。特に§T(テーブル)と§B(バグ)の部分はパイプテーブル形式で記述する必要があり、その形式ルールはリポジトリルートのFORMAT.mdファイルに定義されています。このスキルはClaude Code、Cursor、CodexなどのAIエージェントプラットフォームで動作し、プロジェクト全体の仕様を一元管理することを目的としています。開発者は自然言語で指示するだけで、仕様ドキュメントの作成と維持が可能になります。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/juliusbrussee/cavekit/tree/main/skills/spec

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

spec は何をしますか?

リポジトリルートにあるSPEC.mdを作成、修正、またはバグをバックプロパゲーション(逆伝搬)します。プロジェクト仕様の唯一の変更権限を持つスキルです。ユーザーが仕様の作成、新しいスペックの開始、既存コードからの仕様抽出、不変条件の追加、セクション(§G、§C、§I、§V、§T、§B)の修正、またはバックプロパゲーションによるバグの記録を依頼したときにトリガーされます。

よく使われるフレーズ:

  • "...の仕様を書いて"
  • "新しいスペック"
  • "バグ: ..."
  • "§V.3を修正"
  • "コードから仕様を抽出"
  • "このアイデアをスペック化"

FORMAT.mdを読み取り、§Tと§Bの原始人エンコーディングルールおよびパイプテーブル形式に従います。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

juliusbrussee/backprop

Bug → spec protocol. When a bug is found or a test fails, trace the cause, decide whether a new §V invariant would catch recurrence, append to §B. This is the one non-obvious thing SDD does that plan-then-execute doesn't. Triggers on test failure, bug report, post-mortem, or explicit user ask.

juliusbrussee/build

Plan-then-execute implementation against SPEC.md. Native single-thread loop, no sub-agents. On test or build failure, auto-invokes the backprop skill before retrying — a failed verification always considers whether a new §V invariant would prevent recurrence. Triggers when the user asks to build, implement, execute the spec, or tackle a specific §T task (`build §T.3`, `build --next`, `implement next task`, `run the build`). Expects SPEC.md to exist; if not, defers to the spec skill.

juliusbrussee/caveman

Caveman encoding for SPEC.md and spec-adjacent writes. Loaded by /spec, /build, /check. Cuts tokens ~75% vs prose while staying precise. Triggers on any write to SPEC.md or when user says "caveman", "compress this", "be brief".

juliusbrussee/check

Read-only drift detector. Diffs SPEC.md against current code and reports violations grouped by severity. Writes nothing — suggests remedies via the spec or build skills but never invokes them. Triggers when the user asks to check drift, audit the spec, verify invariants, or ask whether code still matches the spec. Phrasings: "check drift", "audit the spec", "does the code still match §V", "check invariants", "spec vs code".

関連スキル