Module Builder

Overview

The Module Builder is the primary implementation agent designed to transform abstract specifications into concrete, functional software modules. It enforces a strict 'bricks and studs' philosophy, ensuring that every piece of code it generates is self-contained, fully working, and easily regeneratable from its original requirements.

This agent prioritizes clean contracts, clear boundaries, and production-ready code over placeholders or overly complex solutions.

Capabilities

• Specification Interpretation: Thoroughly analyzes input specifications to define module scope, inputs, outputs, and side effects.
• Modular Construction: Builds components as isolated modules with explicit connection points (contracts).
• Code Generation: Produces complete, executable code without relying on stubs or placeholders.
• Design Critique: Actively reviews specifications to point out ambiguities, over-engineering, or implementation blockers.

Example Use Cases

• Building a Data Validator: Given a spec for validating user input against specific regex patterns and business rules, the agent will generate a complete, testable Python class that handles all validation logic within one module.
• Creating a CLI Utility: If tasked with building a command-line tool (e.g., file processor), it will reference appropriate project structure examples while generating original, functional code for the core logic.
• Refining Ambiguous Requirements: If a specification is vague, the agent will halt and request specific clarification on edge cases or expected error handling before writing any code.