Contributing

Developer documentation for contributing to autospec. These docs cover internal architecture, coding standards, and implementation details.

What’s in this section

Document	Description
Architecture	System design, component diagrams, and execution flows
Go Best Practices	Go conventions, naming, and error handling patterns
Internals	Spec detection, validation, retry system, and phase context
Testing & Mocks	Testing patterns and mock implementations
Events System	Event-driven architecture and hooks
YAML Schemas	Detailed YAML artifact schemas and validation
Risks	Risk documentation in plan.yaml

Getting Started

1. Read Architecture for system overview
2. Review Go Best Practices for coding standards
3. Check CLAUDE.md for development commands

Quick Commands

make build          # Build for current platform
make test           # Run all tests
make fmt            # Format Go code
make lint           # Run linters

---

Table of contents

• Architecture
• Go Best Practices
• Internals
• Testing & Mocks
• Events System
• YAML Schemas
• Risks