Why does it use an anti-guesswork checklist?

To eliminate placeholders like 'TBD' or 'later,' forcing all unknowns to be listed as explicit questions to be resolved before development.

What makes a feature specification 'executable'?

A spec is executable when it includes concrete verification steps, environment assumptions, and direct mapping to test IDs, ensuring it can be verified without ambiguity.

Does it integrate with other documentation types?

Yes, it automatically suggests updates to ADRs and the Architecture Overview if the feature introduces new boundaries or dependencies.

How does this skill handle complex system interactions?

It uses Mermaid diagrams to visualize flows between modules and requires precise definitions of entry points, side effects, and idempotency.

MCAF Feature Spec Architect

Name: MCAF Feature Spec Architect
Author: Zendevve

byZendevve

•

Content Management

Generates and maintains executable technical specifications with business rules, Mermaid diagrams, and verification plans.

The MCAF Feature Spec skill automates the creation of high-quality, 'anti-guesswork' documentation based on the Mission-Critical Architecture Framework. It ensures that every feature is defined with testable business rules, clear module interactions, and executable verification steps before implementation begins. By integrating with Architecture Decision Records (ADRs) and existing architecture maps, it maintains a single source of truth that aligns Product, Development, and QA teams throughout the feature lifecycle.

Key Features

01Establishes traceability between business logic and automated test IDs.

02Generates structured Markdown specifications using standardized repository templates.

03Synchronizes feature changes with ADRs and architectural overview documents.

04Enforces testable business rules with defined inputs and expected outputs.

0516 GitHub stars

06Creates visual Mermaid diagrams for system behavior and module interactions.

Use Cases

01Updating technical documentation when business logic or system behavior changes.

02Defining non-trivial feature requirements before starting code implementation.

03Establishing a rigorous Definition of Done for cross-functional team alignment.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add zendevve/opentweak mcaf-feature-spec

For use in Claude.ai and ChatGPT

Download Skill