dev-approach

Generates three isolated solution approaches and a judged selection for feature requests or bug reports.

154|57|Updated Feb 7, 2020
One-click install
npx skills add https://github.com/FHIR/fhir-codegen --skill dev-approach-fhir
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: dev-approach
Source: https://github.com/FHIR/fhir-codegen/tree/main/.github/skills/dev-approach
Command: npx skills add https://github.com/FHIR/fhir-codegen --skill dev-approach-fhir

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Deciding the shape of a solution is cheapest before any plan exists, yet a single agent writing a plan cannot credibly contest the shape it is about to detail. This Skill explores three competing solution designs for a feature request or bug report as isolated staff-level Engineering Leads, then has a skeptical judge select one on the record. ## Core Features & Use Cases - Three Isolated Authors: Fans out three sub-agents optimizing for minimum change, cleanest architecture, and unconstrained reframing, each writing its own approach file without seeing the others. - Skeptical Judge: A fourth sub-agent attacks the self-reported claims in all three approaches and selects exactly one, with comparative justification and non-binding carry-overs. - Slot-Based Workflow: Accepts a full path to a featurerequest.md or bugreport.md, or a slot number that expands to scratch/[MMDD]-[##]/, and supports regenerate, refine, and judge-only re-invocation modes. - Use Case: Before planning a new FHIR cross-version mapping feature, run this Skill on the captured feature request to get three competing designs and a written verdict that dev-plan can build from. ## Quick Start Run the dev-approach skill on slot 2 to generate three competing solution approaches and a judged selection for the feature request captured there.

Frequently Asked Questions about dev-approach

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

FAQPage Schema
How do I compare multiple solution designs before writing an implementation plan?▼

Run this Skill on a featurerequest.md or bugreport.md to fan out three isolated sub-agents that each author a solution shape, then a judge sub-agent selects one with comparative justification. The result is written to approach.md for dev-plan to consume.

How do I regenerate or refine existing approach files?▼

Re-invoke the Skill on a slot that already holds approach files and choose one of three modes: regenerate discards and re-authors all three, refine revises them in place at the cost of some isolation, and judge-only re-runs the judge on the unchanged files.

Can I limit how many sub-agents run in parallel?▼

Yes, the optional max_subagents parameter caps concurrent sub-agents, defaulting to 3. Setting it to 1 serializes the three authors while preserving their isolation, since they still run as independent invocations that never see each other's work.

Does this Skill modify my source code or feature request files?▼

No, the source request file is strictly read-only. The Skill writes exactly four files under the gitignored scratch directory, builds nothing, runs no tests, and never stages, commits, pushes, or publishes anything to GitHub.

What happens if the user disagrees with the judge's selection?▼

The Skill offers a one-time override after writing approach.md. If the user picks a different approach, an Override section is appended below the judge's verdict and becomes authoritative for dev-plan, while the original reasoning stays readable on the record.