sdlc-techdoc

Generates technical design documents with component maps, interface specs, test strategies, and ADRs from SRS inputs.

Updated Jun 1, 2026
One-click install
npx skills add https://github.com/juartaurus98/codebase --skill sdlc-techdoc-juartaurus98
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sdlc-techdoc
Source: https://github.com/juartaurus98/codebase/tree/main/.claude/skills/sdlc-techdoc
Command: npx skills add https://github.com/juartaurus98/codebase --skill sdlc-techdoc-juartaurus98

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It turns a software requirements specification into a complete, reviewable technical design document, eliminating the gap between requirements and implementation planning. ## Core Features & Use Cases - Design Documentation: Produces component maps, data models, interface specs, sequence flows, and error maps aligned to the project's stack profile. - Test Strategy Assignment: Assigns a test level and oracle to every scenario so downstream test phases split cleanly. - ADR Drafting: Drafts architecture decision records at Proposed status for hard-to-reverse decisions, including AI-specific triggers like prompt version bumps and cost budgets. - Use Case: After writing an SRS for a new feature, invoke /techdoc with the feature ID to generate TD-{FEAT-ID}.md plus prompt specs and eval specs for AI features. ## Quick Start Run /techdoc with a feature ID to generate the technical design document from that feature's SRS.

Frequently Asked Questions about sdlc-techdoc

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a technical design document from an SRS?▼

Invoke /techdoc with the feature ID after the SRS exists at the configured srs_dir path. The skill reads the SRS, feature files, and stack profile, then writes TD-{FEAT-ID}.md covering components, data model, interfaces, sequences, and errors.

What inputs does the techdoc phase require?▼

It requires an SRS markdown file plus its .feature files under the feature directory, and reads the stack profile's layers, layout, and coding standards. A hand-written SRS is valid; missing or unmeasurable NFRs cause a NOT_READY stop.

Does it handle AI feature design like prompts and evaluations?▼

Yes, when ai_class is not none it writes a prompt spec per prompt name and an eval-set spec with numeric metric thresholds, judge rubrics, and baselines. It also records model, fallback provider, token budget, and guardrails.

When does it draft architecture decision records?▼

ADRs are drafted at Status Proposed for hard-to-reverse triggers such as new providers, major prompt version bumps, RAG adoption, cost budgets, or sending user data to third parties. They are never marked Accepted by the skill.

What are the limitations of the techdoc skill?▼

It does not write implementation code, add new requirements, or weaken NFRs. Missing requirements are routed back to the SRS phase, and unmeetable NFRs are escalated as product decisions rather than designed around.