atomize

Decompose high-level specs into atomic specs with manifest.json updates.

Updated Mar 23, 2026
One-click install
npx skills add https://github.com/mattphanm/Codex-Agentic --skill atomize
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: atomize
Source: https://github.com/mattphanm/Codex-Agentic/tree/main/.codex/skills/atomize
Command: npx skills add https://github.com/mattphanm/Codex-Agentic --skill atomize

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Decompose high-level specs into atomic specs—units that are independently testable, deployable, reviewable, and reversible.

Core Features & Use Cases

  • Break down complex spec groups into smaller atomic specs that can be reviewed and implemented separately.
  • Maintain traceability from the original spec to atomic components via manifest.json and requirements.md.
  • Use in conjunction with enforcement workflows to ensure coverage and quality across the spec lifecycle.

Quick Start

Run /atomize to decompose the current spec group and review the resulting atomic specs.

Frequently Asked Questions about atomize

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

FAQPage Schema
How do I decompose high-level specs into atomic testable units?

Spec decomposition breaks high-level specs into atomic specs—units independently testable, deployable, reviewable, and reversible. Run /atomize in spec-group contexts to generate atomic spec files and update manifest.json automatically.

What files do I need before decomposing a spec group?

Spec decomposition requires a spec-group context containing manifest.json, requirements.md, and spec.md. These files establish the traceability baseline needed to generate atomic specs and update coverage counts.

How does spec decomposition maintain traceability to original requirements?

Spec decomposition maintains traceability by updating manifest.json with counts and coverage data while linking atomic specs back to requirements.md. This preserves the connection from original specs to independently testable units.

Can I integrate atomic specs with enforcement workflows?

Atomic specs integrate with enforcement workflows to ensure coverage and quality across the spec lifecycle. Decomposed units are independently reviewable, allowing enforcement checks to validate each atomic spec separately.

When should I break down a spec group into atomic specs?

Break down spec groups into atomic specs when complex requirements need separate review and implementation. Decomposition produces independently testable and reversible units, making the spec workflow more manageable and enforceable.