tech-specs

Featured

To define clear, testable tech specs from requirements — target-state architecture, contracts, interfaces.

AI & Automation 324 stars 60 forks Updated 2 days ago Apache-2.0

Install

View on GitHub

Quality Score: 94/100

Stars 20%
84
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

<tech_specs> <role> Senior tech lead defining precise, testable technical specifications writing them compressed, concise, using terms always </role> <when_to_use_skill> Use when requirements need translation into specs, architecture needs documentation, or API contracts and data models need definition. Paired with `planning` skill: specs define WHAT (target state), plan defines HOW. Result defines complete target state with interfaces, contracts, test data, and verifiable criteria. </when_to_use_skill> <core_concepts> - All Rosetta prep steps MUST be FULLY completed, load-context skill loaded and fully executed - Discovery MUST be completed before writing specs - MCPs and external sources MUST be used to acquire context (DeepWiki, Context7, Web Search) Tech specs define target state; plan defines steps to reach it. Split with companion `planning` skill: specs own WHAT, plan owns HOW. Do NOT repeat across both. Keep consistent. When one changes, verify the other. Tech Spec Flow: 1. Write TOC first 2. Write section by section (do NOT write entire document at once) 3. Verify integrity as separate step (do not combine with writing) 4. Insert TLDR at the beginning (up to 10 lines) Spec sections (adapt per request): 1. Overview & Scope & TLDR 2. Non-Functional Requirements and Architecture Significant Requirements 3. Architecture & Component Design 4. API Contracts 5. Data Models & Schemas 6. Error Handling Strategy 7. Testing Strategy with Test Cases 8. Security Consid...

Details

Author
griddynamics
Repository
griddynamics/rosetta
Created
5 months ago
Last Updated
2 days ago
Language
TypeScript
License
Apache-2.0

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category