What is the brick philosophy in this skill?

The brick philosophy treats modules as self-contained units with a single responsibility and a defined public contract (studs) for external connections.

Where are the module specifications saved?

All generated specifications are automatically saved to a central 'Specs/' directory within your project for easy discovery and reference.

Does it support Python type hinting?

Yes, the generator specifically extracts and documents full type hints for functions and data models to ensure the public contract is precise.

Can this skill document existing codebases?

Yes, the skill can analyze existing files to extract signatures, dependencies, and structure to create retrospective specifications for any module.

How does this help with AI coding agents?

Clear specifications allow AI agents to rebuild or modify specific modules independently while preserving the connection points that other modules rely on.

Module Spec Generator

Name: Module Spec Generator
Author: rysweet

byrysweet

•

开发者工具

Automates the creation of comprehensive module specifications based on the amplihack brick-and-stud architecture philosophy.

The Module Spec Generator skill empowers developers to document and design modular systems by extracting high-quality specifications from code analysis. Following the amplihack 'brick' philosophy, it ensures every module has a single responsibility and a clearly defined public contract (studs), making modules completely regeneratable without breaking system connections. This tool is ideal for documenting existing codebases, planning new features before implementation, and maintaining architectural integrity across complex agentic coding projects by ensuring every component is self-contained and well-defined.

主要功能

01Maps internal and external dependencies to identify circularity and architectural bloat

02Defines clear test requirements and coverage goals for every generated module spec

03Produces consistent Markdown documentation in a central, discoverable directory

0416 GitHub stars

05Generates standardized brick & studs specifications to ensure modular system integrity

06Extracts public contracts, signatures, and data models automatically via deep code analysis

使用场景

01Verifying that an implementation still accurately matches its original design specification

02Standardizing documentation for legacy codebases during a major refactor

03Designing the architecture and interface of new modules before implementation begins

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add rysweet/amplihack module-spec-generator

For use in Claude.ai and ChatGPT

Download Skill