Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add skills/careerchain-ys/stdd/reverse-engineering-common-specnpx skills add careerchain-ys/stdd --skill reverse-engineering-common-specgit clone --depth 1 https://github.com/careerchain-ys/stddWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/careerchain-ys/stdd/reverse-engineering-common-spec)<a href="https://agentmods.dev/skills/careerchain-ys/stdd/reverse-engineering-common-spec"><img src="https://agentmods.dev/badge/skills/careerchain-ys/stdd/reverse-engineering-common-spec.svg" alt="Measured on agentmods" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00167 | $0.02608 |
| Opus 5 | $0.00084 | $0.01304 |
| Sonnet 5 | $0.00033 | $0.00522 |
| Haiku 4.5 | $0.00017 | $0.00261 |
Grade A, and why
reverse-engineering-common-spec scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 150 lines — stays where its author put it; the contents beside it link to each section on GitHub.
common spec のリバースエンジニアリング
既存(稼働中)プロジェクトに STDD を導入する際、コードベース全体を input にして common 階層の Spec を作成する。
| 出力 | 内容 |
|---|---|
docs/common/REQUIREMENTS.md |
サービス概要・登場アクター・アプリ構成(プロジェクト全体のビジネス要件) |
docs/common/ARCHITECTURE.md |
システム概要(システム構成・リポジトリ構成・レイヤ規約・スタック・連携・セキュリティ・インフラ。データモデル/API は持たない) |
docs/common/TABLE_DEFINITION.md |
全テーブル定義の SSoT(カード形式・ER図なし) |
docs/common/API_SPEC.md |
API 契約の SSoT(OpenAPI 風 Markdown。API がある場合) |
このうち ARCHITECTURE.md / TABLE_DEFINITION.md / API_SPEC.md は技術 spec (tech_specs) の common 分にあたる(→ stdd-methodology.md §3)。テンプレートは ../documenting-requirements/templates/requirements-common.md(REQUIREMENTS)/ ../documenting-tech-specs/templates/architecture-common.md(ARCHITECTURE。TABLE_DEFINITION / API_SPEC も同ディレクトリ)を参照する。
位置づけ — 導入時に一度だけ
common 階層はプロジェクト全体で 1 組しか存在しない SSoT であり、本スキルは STDD 導入時に一度だけ実行する想定。
作成後の更新(アーキテクチャ変更時など)は本スキルではなく、通常の Spec 更新として documenting-requirements(要件)/ documenting-tech-specs(ARCHITECTURE 等の技術設計)で扱う。
STDD 導入フロー(既存プロジェクト)
1. reverse-engineering-common-spec ← 本スキル(一度だけ)
↓ common 階層が揃う
2. reverse-engineering-feature-spec ← 機能ごとに繰り返す
↓
3. auto-implement ← 以降の新機能は順行 STDD
順序の理由: 先に common 階層(レイヤ規約・共有ドメインモデル・テーブル定義・API 契約)を固定しておくと、後続の機能単位リバース(reverse-engineering-feature-spec)の精度と速度が上がる。
最重要原則 — 実装・設定が真実
common 階層でも 実装が真実(Source of Truth) である。推測や理想論で書かず、必ず一次情報を確認してから書く。 feature 階層と違い、確認する一次情報は UI 文言ではなく構成・設定・型定義 である。
| 記述する内容 | 確認元(一次情報) | よくある間違い |
|---|---|---|
| アプリ構成・責務 | トップレベルディレクトリ / README | 想像でアプリ名・責務を書く |
| パッケージ分割 | package.json の workspaces / 依存定義 |
モジュール境界を推測で書く |
| レイヤ規約・依存方向 | domain/ 配下の実構成・lint ルール |
一般論の Clean Architecture を書く |
| 外部サービス連携 | 環境変数・SDK の import 箇所 | 使っていないサービスを書く/使用中を漏らす |
| テーブル一覧(TABLE_DEFINITION) | 生成された DB 型定義(database.types.ts 等) |
テーブル名・カラム名を想像で書く |
| デプロイ・環境 | CI/CD 設定(.github/workflows 等) |
ブランチ→環境マッピングを推測で書く |
読む順序とチェックリスト
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 5d ago First seen · 150 lines · 167 tokens per session scan A 793d17d2c077
reverse-engineering-common-spec is a skill published in the GitHub repository careerchain-ys/stdd (2 stars, last pushed 1mo ago), licensed Apache-2.0. It adds 167 tokens to every session and 2,608 once invoked, about $0.0008 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other skills, from other repositories
systematic-debugging
Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes.
local-ai-agents
Build local-first AI agents that run entirely on a developer workstation with Microsoft Foundry Local and Qwen function-calling models. Covers Small Language Models (SLMs), the OpenAI-compatible local endpoint, sandboxed local tools, local RAG with Chroma, local MCP servers, hybrid cloud/local routing, and the…
next-cache-components-adoption
Turn on Cache Components in a Next.js app and resolve the blocking routes it surfaces. Use when the user wants to enable, adopt, or migrate to Cache Components, flip the cacheComponents flag, work through a flood of blocking-prerender / instant validation errors, run the cache-components-instant-false codemod, or…
next-cache-components-optimizer
Drive a Next.js route to instant navigation by setting up an agentic loop, under Cache Components / PPR, on initial load (hard navigation) and client-side navigation (soft navigation). Encode the goal as a failing @next/playwright instant() e2e and work it to green, one verified route at a time; the shipped test then…
next-partial-prefetching-adoption
Turn on Partial Prefetching in a Next.js app and work through the insights it surfaces. Use when the user wants to enable or adopt Partial Prefetching, flip the partialPrefetching flag, opt routes in with export const prefetch = 'partial', audit Link prefetch={true} behavior, preserve existing prefetched UI with…
chronicle
Analyze Copilot session history for standup reports, usage tips, session search, and session reindexing. Use when the user asks for a standup, daily summary, usage tips, workflow recommendations, wants to search or find past sessions by keyword/file/PR, wants to reindex their session store, or asks about deleting…