Firstmate documentation
Firstmate is the captain's operating layer for software work across projects.
It keeps the captain-facing conversation simple while coordinating project work, safety checks, validation, documentation, and follow-up.
Fast path for readers
- Read Firstmate core and soul for the philosophy.
- Read Multi-project operations for how one Firstmate coordinates many repositories.
- Read System map for the architecture.
- Read Setup to install or verify a home.
- Read Working well with Firstmate to get better outcomes.
- Use Commands reference when operating the system.
Section map
- Concepts define the mental model.
- Architecture explains the system shape and durable records.
- Guides give setup and daily-use steps.
- Workflows show repeatable end-to-end paths, including routing and assignment.
- Patterns capture reusable operating choices.
- Components explain harnesses, skills, scripts, and tools.
- Examples show complete scenarios.
- Snippets provide small reusable text blocks.
- Troubleshooting handles common failures.
- Reference is for exact lookup.