Skip to content
Design Rationale

21 Skill Design Rationale Docs

This layer sits between the cross-skill principles in Best Practice and the executable artifacts in Skills. Each document makes the design reasoning, key tradeoffs, and problem framing explicit — rather than leaving them implicit inside SKILL.md.

Pipeline 6 skills
go-makefile-writer Why gate-based Makefile design outperforms flat target lists git-commit Conventional commits enforcement and safety protocol design create-pr Evidence-backed PR generation and full diff analysis go-ci-workflow CI pipeline design for Go: lint, test, build, release gates go-code-reviewer Multi-agent parallel review and grep-gated checklist execution security-review Exploitability-first triage and OWASP-aligned scan design
Testing 7 skills
unit-test TDD enforcement, table-driven patterns, and 80% coverage gates tdd-workflow Red-green-refactor cycle design and test-first discipline api-integration-test Real-database integration over mocks: rationale and tradeoffs e2e-test Playwright journey design and quarantine strategy for flaky tests fuzzing-test Go fuzz test generation: corpus design and boundary targeting thirdparty-api-integration-test Gated real-API tests: guard design and credential safety systematic-debugging Hypothesis-driven debugging loops and evidence accumulation
Research 2 skills
google-search Iterative retrieval design and query refinement protocol deep-research Multi-source synthesis and progressive disclosure for long research
Docs 4 skills
writing-plans Plan structure, context sections, and verification protocol update-doc Codemaps and docs sync: staleness detection and update gates readme-generator README content strategy and audience-first framing tech-doc-writer Technical writing quality gates and progressive review design
Tools 2 skills
yt-dlp-downloader yt-dlp wrapper design: format selection and error handling local-transcript Local audio transcription pipeline and model selection rationale

中文版 →