implement-from-spec

Implements scoped code slices from approved design docs using phased test-first workflows.

3|Updated Feb 15, 2025
One-click install
npx skills add https://github.com/mark-torres10/ai_tools --skill implement-from-spec-mark-torres10
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: implement-from-spec
Source: https://github.com/mark-torres10/ai_tools/tree/main/skills/implement-from-spec
Command: npx skills add https://github.com/mark-torres10/ai_tools --skill implement-from-spec-mark-torres10

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Turning an approved design doc or plan into working code often goes wrong: scope creeps, business logic sneaks in during scaffolding, tests get written after implementation, and multiple changes get batched into one commit. This Skill enforces a disciplined six-phase workflow that keeps each implementation slice small, test-driven, and reviewable. ## Core Features & Use Cases - Phased Implementation Workflow: Six mandatory phases (scope, scaffold, contracts, test design, incremental implementation, completion) with explicit pass/fail gates per phase. - Caller-First Scoping: Identifies the single main caller and happy-path slice before writing any code, keeping sibling plan packets out of scope. - Test-First Discipline: Requires given/when/then pseudocode converted to failing tests before any unit of work is implemented, with one Git commit per step. - Use Case: You have an approved design for a data pipeline. Use this Skill to scaffold the modules, agree on contracts, design failing tests, then implement get, write, transform, and run one commit at a time until the caller path is green. ## Quick Start Implement the repository slice from my approved design doc at docs/pipeline-design.md using the implement-from-spec workflow, starting with caller-first scoping.

Frequently Asked Questions about implement-from-spec

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

FAQPage Schema
How do I implement code from a design doc step by step?

Follow the six-phase workflow: scope the main caller and slice, scaffold files with stub bodies, define contracts for approval, design failing tests from given/when/then pseudocode, then implement one unit of work at a time in dependency order. Each phase has a gate that must pass before continuing.

How to enforce test-driven development when implementing a plan?

Write given/when/then pseudocode scenarios first, convert each into a named real test, and confirm they fail for the right reasons before writing any implementation. Then implement one function per iteration, running targeted tests and committing each unit separately.

When should I not use a spec-implementation workflow?

Do not use it when you are still comparing design options or still writing the implementation plan, since it assumes an approved spec exists. It also does not fit unscoped requests to build an entire design at once with no defined caller or slice.

Why implement one function per commit instead of the whole module?

One unit of work per commit keeps diffs reviewable, makes newly green versus still-red tests explicit, and prevents drive-by refactors. Dependency-order implementation along the caller path also ensures each commit advances the happy path rather than unrelated files.

Can I skip the contract approval step in the workflow?

Contract approval after Phase 3 can only be skipped if the user explicitly requests full auto or unattended execution. Otherwise the workflow stops to present models, interfaces, and signatures for approval before test design begins.