Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
42 changes: 42 additions & 0 deletions agents/Mathews-Tom__project-architect/README.md
Original file line number Diff line number Diff line change
@@ -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.
Binary file added agents/Mathews-Tom__project-architect/banner.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added agents/Mathews-Tom__project-architect/icon.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
24 changes: 24 additions & 0 deletions agents/Mathews-Tom__project-architect/metadata.json
Original file line number Diff line number Diff line change
@@ -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
}