distill

Extract domain entities, states, transitions, and boundaries into an Allium-style spec.

1|Updated May 22, 2013

Search Tags:#specification #distill #reverse-engineering #code-to-spec #allium

Ready to run

npx skills add https://github.com/scottopell/dotfiles --skill distill-scottopell

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: distill
Source: https://github.com/scottopell/dotfiles/tree/main/home-dir-configs/claude/skills/allium/skills/distill
Command: npx skills add https://github.com/scottopell/dotfiles --skill distill-scottopell

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Distill complex codebases into concise, domain-focused Allium specifications that capture intents, omissions, and boundaries.

Core Features & Use Cases

Extract domain entities, states, transitions, and rules from existing implementations.
Document scope, ownership, and boundaries to guide future refactors or new features.
Use to generate a formal Allium spec from monorepos, microservices, or libraries to align teams.

Quick Start

Identify a codebase you want to distill, then run the distill process to produce an Allium-style spec covering core domains and interactions.

Frequently Asked Questions about distill

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

FAQPage Schema

How do I extract domain specifications from an existing codebase?▼

To extract domain specifications from an existing codebase, you can distill the source code into a structured Allium spec. This process identifies core domain entities, states, transitions, and boundaries while separating domain concerns from implementation details.

What is the best way to reverse-engineer a monorepo into a formal spec?▼

The best way to reverse-engineer a monorepo into a formal spec is to use a code-to-spec distillation process. It transforms complex multi-service architectures into concise, domain-focused Allium specifications that capture intents and omissions.

Can I generate an Allium spec from microservices to align teams?▼

Yes, you can generate an Allium spec from microservices to align teams. The distillation process extracts domain rules, entities, and boundaries from multi-service architectures, producing a formal specification to guide future development.

Does reverse-engineering code into domain specs work for monorepos?▼

Reverse-engineering code into domain specs works effectively for monorepos. The distillation process separates domain concerns from implementation details across the codebase, outputting a structured spec detailing entities, states, and transitions.

When do I need to distill a codebase into a domain specification?▼

You need to distill a codebase into a domain specification when documenting scope, ownership, and boundaries to guide future refactors or new features. It helps align teams by capturing intents and omissions across complex architectures.

How do I document domain boundaries and states from an existing implementation?▼

To document domain boundaries and states from an existing implementation, apply a code-to-spec distillation process. It extracts entities, states, transitions, and rules from the source code into a structured Allium specification.