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.

主な機能

Maps internal and external dependencies to identify circularity and architectural bloat
Defines clear test requirements and coverage goals for every generated module spec
Produces consistent Markdown documentation in a central, discoverable directory
16 GitHub stars
Generates standardized brick & studs specifications to ensure modular system integrity
Extracts public contracts, signatures, and data models automatically via deep code analysis

ユースケース

Verifying that an implementation still accurately matches its original design specification
Standardizing documentation for legacy codebases during a major refactor
Designing the architecture and interface of new modules before implementation begins

概要

主な機能

Maps internal and external dependencies to identify circularity and architectural bloat
Defines clear test requirements and coverage goals for every generated module spec
Produces consistent Markdown documentation in a central, discoverable directory
16 GitHub stars
Generates standardized brick & studs specifications to ensure modular system integrity
Extracts public contracts, signatures, and data models automatically via deep code analysis

ユースケース

Verifying that an implementation still accurately matches its original design specification
Standardizing documentation for legacy codebases during a major refactor
Designing the architecture and interface of new modules before implementation begins