carl-dev-flow-tech-spec

Draft technical specifications through revised and final stages with ADRs.

1|Updated Mar 11, 2026

Search Tags:#architecture #documentation #collaboration #adr #review #stakeholders #technical-spec

Ready to run

npx skills add https://github.com/C-ra-ZY/carl-dev-flow-skills --skill carl-dev-flow-tech-spec

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: carl-dev-flow-tech-spec
Source: https://github.com/C-ra-ZY/carl-dev-flow-skills/tree/main/skills/carl-dev-flow-tech-spec
Command: npx skills add https://github.com/C-ra-ZY/carl-dev-flow-skills --skill carl-dev-flow-tech-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps organizations converge on a precise and actionable technical specification by guiding the drafting, feasibility review, and revision processes across the Sisyphus and Hephaestus roles.

Core Features & Use Cases

Guides drafting, feasibility evaluation, and finalization of technical specs for complex software projects.
Captures decisions, tradeoffs, and ADRs, and stores artifacts under .carl/tech-spec.
Enables structured collaboration among product, architecture, and operations stakeholders through the entire review lifecycle.

Quick Start

Provide a working technical spec draft and initiate the review with Sisyphus and Hephaestus.

Frequently Asked Questions about carl-dev-flow-tech-spec

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

FAQPage Schema

How do I collaboratively finalize a technical specification for a software project?▼

To collaboratively finalize a technical specification, you draft the document and shepherd it through draft, revised, and final stages. This process captures architecture decisions, tradeoffs, and ADRs to provide clear outcomes for stakeholders.

What is the best way to document architecture decisions and tradeoffs during a technical spec review?▼

Documenting architecture decisions and tradeoffs during a technical spec review requires capturing explicit ADRs and storing artifacts. The specification promotes to final only after defining concrete implementation paths for stakeholders.

Can I use this technical spec workflow for projects requiring structured stakeholder collaboration?▼

Yes, you can use this technical spec workflow for stakeholder collaboration. It guides product, architecture, and operations stakeholders through the entire review lifecycle, from initial feasibility evaluation to finalization.

Do I need a working technical spec draft to start the architecture review process?▼

Yes, you need to provide a working technical spec draft to start the architecture review process. Initiate the review to evaluate feasibility and guide revisions across the structured collaboration lifecycle.

Where are technical specification artifacts and ADRs stored during the review lifecycle?▼

Technical specification artifacts and ADRs are stored under the .carl/tech-spec directory. Storing documentation here ensures decisions and tradeoffs are captured and accessible for stakeholder review.