technical-spec

Installation
SKILL.md

Technical Specification

This is the architectural keystone of the doc pipeline: it runs after the business docs exist (docs/business/: user stories, AC, sprint breakdown) and before the API specs, task breakdown, coding standard, and deployment plan, all of which depend on the decisions made here. Get the tech stack and data model right and everything downstream is buildable; get them wrong and every later doc inherits the error.

When this set is written and confirmed, the next step is api-spec, which projects the module definitions and data model into the docs/api-specs/ endpoint contracts in whatever protocol the tech stack chose.

Output is a numbered file set under docs/technical-specs/, not one monolith (_index.md plus NN-topic.md files), so sections are linkable from task cards and reviews (e.g. technical-specs/06-data-model.md section 6.5).

Two phases: grill on the architecture, then write the set.

Running project (adopt mode). If the repository already has working code, describe the system as built. Read the code, the config, the schema or migrations, and the deploy files, and write each section from what exists. The grill confirms what you read; it does not redesign. Record every gap or inconsistency you find (no rate limit, two auth paths, a table with no owner module) in a Findings list at the end of the section it belongs to, and repeat the list in your report. docs/business/ may not exist; then leave out the AC and US traceability, and say so in _index.md.

Phase 1: Grill (tech stack and tooling first)

Read the source of truth before asking: all of docs/business/, plus any existing CLAUDE.md or AGENTS.md, README, or partial specs. The business docs define what is built; this document defines how. Then interview the user one question at a time, recommending an answer for each and explaining the trade-off, until every architectural branch is resolved.

This is a genuine grill, not a form. Hold the discipline:

Installs
31
GitHub Stars
9
First Seen
Jul 27, 2026