forge-architect

Cross-Platform AI Agent Skill This skill works with any AI agent platform that supports the skills.sh standard.

System Architecture

Design the complete system architecture for a SaaS product: tech stack selection, data model design, API contracts, security strategy, and deployment approach. This skill reads docs/project-brief.md as input and produces docs/architecture.md as output.

Anti-Hallucination Guidelines

CRITICAL: Architecture decisions must be grounded in actual requirements and verified capabilities:

1. Read the brief first — Never design without reading docs/project-brief.md; every decision must trace back to a requirement
2. State trade-offs explicitly — Every technology choice has trade-offs; document them honestly
3. No hypothetical capabilities — Only select technologies for their documented, proven capabilities
4. Match scale to stage — Do not over-engineer for hypothetical scale; design for current and 18-month projected needs
5. Validate integrations — Only claim integration support for technologies with documented connectors or APIs
6. Name real patterns — Use established architectural pattern names (monolith, event-driven, CQRS) with their actual implications