needs-implementation

Implement feature code from design and task artifacts in phased workflows.

Updated Feb 19, 2026
One-click install
npx skills add https://github.com/provenimpact/proven-needs --skill needs-implementation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: needs-implementation
Source: https://github.com/provenimpact/proven-needs/tree/main/skills/needs-implementation
Command: npx skills add https://github.com/provenimpact/proven-needs --skill needs-implementation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Implement code for a feature from its task list or design. Use when the proven-needs orchestrator determines that a feature needs code implementation. Operates within a single feature package at docs/features/<slug>/. Reads the feature's tasks and design to produce working code, one phase at a time. After each phase, verifies the build, commits, and asks the user before proceeding.

Core Features & Use Cases

  • Orchestrates end-to-end feature implementation based on design and task artifacts.
  • Supports phased execution with per-phase verification and user prompts.
  • Works within a single feature package, updating docs and code incrementally.

Quick Start

Begin Phase 1 implementation by reading docs/features/needs-implementation/tasks.adoc and docs/features/needs-implementation/design.adoc, then code, verify, and commit.

Frequently Asked Questions about needs-implementation

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

FAQPage Schema
How do I convert feature designs into working code automatically?

To convert feature designs into working code, this Skill reads design.adoc and tasks.adoc artifacts to orchestrate phased code generation. It translates design specifications into functional code, executing implementation sequentially while maintaining alignment with the original feature requirements.

How does phased feature implementation with per-phase verification work?

Phased feature implementation breaks the workflow into sequential stages, executing code generation for each phase and verifying builds and tests before committing. The Skill pauses for user prompts after each phase, ensuring incremental progress and design alignment before proceeding to the next stage.

What file structure do I need for orchestrator-driven code generation?

Orchestrator-driven code generation requires a single feature package located at docs/features/<slug>/. You need docs/features/needs-implementation/tasks.adoc and design.adoc files present within this directory to guide the implementation workflow and provide the necessary design and task artifacts.

Can I automate end-to-end feature implementation across multiple phases?

Yes, you can automate end-to-end feature implementation across multiple phases. The Skill orchestrates the entire workflow from reading task artifacts to generating code, verifying builds, and committing progress sequentially. It handles divergences by reporting them back to the orchestrator for resolution.

What happens if the generated code diverges from the original design?

If generated code diverges from the original design, the Skill reports these divergences to the orchestrator. This mechanism ensures design alignment is maintained throughout the phased implementation, allowing for corrective adjustments without silently continuing with broken or misaligned feature code.