What is the 'brick philosophy' in this skill?

The brick philosophy views modules as self-contained units with a single responsibility. They connect via 'studs' (public contracts), allowing them to be regenerated without breaking the rest of the system.

How does this help with AI agent coding?

It provides a clear roadmap for AI agents. By defining the 'studs' (API) and requirements first, agents can implement or rebuild modules with much higher accuracy and less regression.

Can this skill document existing Python code?

Yes, it can scan your directory, analyze imports, and extract public interfaces and dependencies to create a retrospective specification for existing modules.

Where does the skill store the generated specifications?

By default, all specifications are generated as Markdown files and saved in a central 'Specs/' directory within your project for easy discovery.

Module Specification Generator

Name: Module Specification Generator
Author: rysweet

byrysweet

•

学習とドキュメンテーション

Generates standardized module specifications following the brick-and-studs philosophy for modular, regeneratable code.

This skill streamlines the architectural design process within the Amplihack framework by automatically generating comprehensive module specifications. By analyzing existing code or user requirements, it extracts public contracts (studs), maps dependencies, and defines test requirements to ensure every module functions as a self-contained 'brick.' This enables developers and AI agents to build, document, and regenerate modules independently without breaking system connections, preserving long-term maintainability and architectural integrity.

主な機能

0116 GitHub stars

02Adherence to the 'brick philosophy' for modular, single-responsibility design

03Dependency mapping for standard, external, and internal libraries

04Standardized Markdown templates for consistent, discoverable documentation

05Automated code analysis to extract public function signatures and data models

06Structured test requirement generation including coverage targets

ユースケース

01Defining new module requirements before implementation to ensure architectural alignment

02Documenting existing codebases to facilitate agentic coding and future refactors

03Verifying that current implementations strictly follow their documented public contracts

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