diff --git a/agents/Mathews-Tom__project-architect/README.md b/agents/Mathews-Tom__project-architect/README.md new file mode 100644 index 0000000..c7cbfee --- /dev/null +++ b/agents/Mathews-Tom__project-architect/README.md @@ -0,0 +1,42 @@ +# project-architect + +System architecture agent that conducts phased requirements discovery and produces comprehensive architecture documents with technology stack justification, Mermaid diagrams, data flow design, and implementation roadmaps. Gathers business context before proposing technical solutions. + +## Run + +```bash +npx @open-gitagent/gitagent run -r https://github.com/Mathews-Tom/project-architect +``` + +## What It Can Do + +- **Business Discovery** — extracts product understanding, success metrics, constraints, and compliance requirements through structured questioning +- **Technical Requirements** — gathers core functionality, platform needs, performance targets, and security requirements +- **Technology Selection** — evaluates 2-3 options per component with scoring against requirements and tradeoff rationale +- **Architecture Document Production** — generates executive summary, component breakdown, data architecture, security design, API design, and infrastructure topology with Mermaid diagrams +- **ADR Generation** — produces Architecture Decision Records for key decisions with context, alternatives, and consequences +- **Self-Validation** — reviews the produced architecture for missing components, scalability bottlenecks, and security gaps + +## Structure + +``` +project-architect/ +├── .gitignore +├── LICENSE +├── README.md +├── RULES.md +├── SOUL.md +├── agent.yaml +├── assets/ +│ ├── icon.png +│ └── banner.png +└── knowledge/ + ├── architecture-patterns.md + ├── tech-stack-evaluation.md + ├── mermaid-diagram-guide.md + └── adr-template.md +``` + +## Built with + +Built for the [gitagent](https://gitagent.sh) ecosystem. diff --git a/agents/Mathews-Tom__project-architect/banner.png b/agents/Mathews-Tom__project-architect/banner.png new file mode 100644 index 0000000..2c898b8 Binary files /dev/null and b/agents/Mathews-Tom__project-architect/banner.png differ diff --git a/agents/Mathews-Tom__project-architect/icon.png b/agents/Mathews-Tom__project-architect/icon.png new file mode 100644 index 0000000..b6b1f00 Binary files /dev/null and b/agents/Mathews-Tom__project-architect/icon.png differ diff --git a/agents/Mathews-Tom__project-architect/metadata.json b/agents/Mathews-Tom__project-architect/metadata.json new file mode 100644 index 0000000..a22dae4 --- /dev/null +++ b/agents/Mathews-Tom__project-architect/metadata.json @@ -0,0 +1,24 @@ +{ + "name": "project-architect", + "author": "Mathews-Tom", + "description": "System architecture agent producing architecture documents with tech stack justification, Mermaid diagrams, and data flow design", + "repository": "https://github.com/Mathews-Tom/project-architect", + "version": "1.0.0", + "category": "developer-tools", + "tags": [ + "architecture", + "system-design", + "tech-stack", + "mermaid", + "requirements", + "adr" + ], + "license": "MIT", + "model": "claude-opus-4-6", + "adapters": [ + "claude-code", + "system-prompt" + ], + "icon": true, + "banner": true +}