Skip to content
Back to search

project-architect

Documentation-first project planning agent skill. Generates specs, implementation plans, tasks, and single-shot prompts for coding agents. Compatible with Claude Code, Cursor, Codex, and 40+ agents via agentskills.io.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked yesterday
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ersinkoc--project-architect/badge.svg)](/listings/ersinkoc--project-architect)

HTML

<a href="/listings/ersinkoc--project-architect"><img src="/api/listings/ersinkoc--project-architect/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Universal (any agent) via skills CLI

The easiest way to install, works with all [agentskills.io-compatible agents](https://agentskills.io):

npx skills add ersinkoc/project-architect

This auto-detects your coding agent and installs to the correct location.

**Install for a specific agent:**

npx skills add ersinkoc/project-architect --agent wrongstack
npx skills add ersinkoc/project-architect --agent claude-code
npx skills add ersinkoc/project-architect --agent cursor
npx skills add ersinkoc/project-architect --agent codex

**Install globally (all projects):**

npx skills add ersinkoc/project-architect --global

> Repository: [github.com/ersinkoc/project-architect](https://github.com/ersinkoc/project-architect)

Claude Code (plugin mode)

Add to your project's `.claude/settings.json`:

{
  "plugins": [
    "/absolute/path/to/project-architect"
  ]
}

Or add to `~/.claude/settings.json` for global availability.

Manual installation (any agent)

Clone the repo and copy/symlink the skill directory into your agent's skills folder:

| Agent | Skills Directory | |-------|-----------------| | WrongStack | `.wrongstack/skills/` or `~/.wrongstack/skills/` | | Claude Code | `.claude/skills/` or `~/.claude/skills/` | | Cursor | `.cursor/skills/` or `~/.cursor/skills/` | | GitHub Copilot | `.github/skills/` | | Codex | `.codex/skills/` | | Gemini CLI | `.gemini/skills/` | | OpenCode | `.opencode/skills/` | | Generic | `.agents/skills/` or `~/.agents/skills/` |

# Example: install for WrongStack globally
git clone https://github.com/ersinkoc/project-architect.git
ln -s $(pwd)/project-architect ~/.wrongstack/skills/project-architect

# Example: install for Claude Code globally
ln -s $(pwd)/project-architect ~/.claude/skills/project-architect

# Example: install for Cursor in a project
ln -s $(pwd)/project-architect .cursor/skills/project-architect

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

plugin.json · Manifest · 8 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "project-architect",
  3. "version": "1.1.0",
  4. "description": "Documentation-first project planning that produces agent-ready prompts. Generates interconnected docs (SPECIFICATION, IMPLEMENTATION, TASKS, BRANDING) plus a self-contained, single-shot PROMPT.md for execution by any coding agent (WrongStack, Claude Code, Cursor, and more).",
  5. "skills": [
  6. "SKILL.md"
  7. ]
  8. }
README.md · README · 246 lines · 2 findings marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Project Architect
  2. An [Agent Skill](https://agentskills.io) for **documentation-first project planning**. Transforms a project idea into implementation-ready blueprints and a single-shot coding agent prompt.
  3. Compatible with **40+ coding agents** including WrongStack, Claude Code, Cursor, Gemini CLI, GitHub Copilot, Codex, and more.
  4. ---
  5. ## ⚡ Sponsored by WrongStack
  6. <div align="center">
  7. ### _Built on the wrong stack. Shipped anyway._
  8. **[WrongStack](https://wrongstack.com)** is a free, [open-source](https://github.com/WrongStack/WrongStack) AI coding agent with a Brain, a Memory, and a full toolbox. It reads your code, edits files, runs commands, and coordinates specialist agents — across six surfaces, from a plain terminal REPL to a cross-machine HQ dashboard. No subscription required, and you keep your hand on every permission.
  9. [![Website](https://img.shields.io/badge/%F0%9F%8C%90_Website-wrongstack.com-6E56CF?style=for-the-badge)](https://wrongstack.com)
  10. &nbsp;
  11. [![GitHub](https://img.shields.io/badge/GitHub-WrongStack%2FWrongStack-181717?style=for-the-badge&logo=github)](https://github.com/WrongStack/WrongStack)
  12. &nbsp;
  13. [![Stars](https://img.shields.io/github/stars/WrongStack/WrongStack?style=for-the-badge&color=e3b341&logo=github)](https://github.com/WrongStack/WrongStack/stargazers)
  14. ```bash
  15. curl -fsSL https://wrongstack.com/install.sh | sh # macOS / Linux — self-contained binary
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 25 on GitHub
  16. ```
  17. ```powershell
  18. irm https://wrongstack.com/install.ps1 | iex # Windows (PowerShell) — no Node.js needed
  19. ```
  20. </div>
  21. | | What you get |
  22. |---|---|
  23. | 🌐 **[200+ LLM providers](https://wrongstack.com)** | Catalog pulled live from models.dev — Anthropic, OpenAI, Google, plus OAuth sign-in for Claude Pro/Max, ChatGPT and Copilot, and any OpenAI-compatible endpoint (Ollama, vLLM, LM Studio) |
  24. | 🛠️ **[67 built-in tools](https://github.com/WrongStack/WrongStack)** | Edits, lint/typecheck/test, execution, git, web, browser/E2E and a SQLite codebase index — every call gated by per-tool permissions |
  25. | 🧠 **[SAGE memory](https://github.com/WrongStack/WrongStack/blob/main/docs/sage/ARCHITECTURE.md)** | Project-wide long-term memory in SQLite/FTS5, anchored to files, symbols and commits — it gets better at *your* codebase over time |
  26. | 🖥️ **[Six surfaces](https://wrongstack.com)** | Readline REPL · Ink/React TUI (`--tui`) · WebUI · SimpleUI · Desktop · cross-machine HQ (`--hq`) |
  27. | 🤖 **[Fleet orchestration](https://github.com/WrongStack/WrongStack/blob/main/docs/director-architecture.md)** | A Director fans out specialist subagents over a project mailbox; `eternal` & `parallel` goal loops run until the contract verifies |
  28. | 🔍 **[Chimera & Kanban](https://wrongstack.com)** | Auto-review agents that critique your diffs with severity-ranked findings, plus durable Kanban boards with atomic verification |
  29. | 🔐 **[Secure by default](https://github.com/WrongStack/WrongStack/blob/main/SECURITY.md)** | Encrypted secrets at rest, project-root containment, opt-in YOLO mode — MIT licensed, TypeScript-strict |
  30. > **📊 The perfect pairing:** This band tells you exactly where your Claude limits stand — and **WrongStack** keeps you moving when they close in. It reads plan windows for Claude, ChatGPT, Copilot, Z.AI and more right in its own statusline and quota page, and when one provider runs dry, **fallback chains** rotate you onto the next model automatically. Watch the band, dodge the wall.
  31. <div align="center">
  32. 🔗 **[wrongstack.com](https://wrongstack.com)** &nbsp;·&nbsp; **[github.com/WrongStack/WrongStack](https://github.com/WrongStack/WrongStack)** &nbsp;·&nbsp; ⭐ **[Star it on GitHub](https://github.com/WrongStack/WrongStack/stargazers)**
  33. </div>
  34. ---
  35. ## What It Does
  36. Given a project idea, Project Architect walks you through an interactive discovery process and generates 5 interconnected documents:
  37. ```
  38. [Discovery] -> SPECIFICATION.md -> IMPLEMENTATION.md -> TASKS.md -> BRANDING.md
  39. (The What) (The How) (The Work) (Identity)
  40. | | |
  41. +-------------------+------------------+
  42. |
  43. PROMPT.md
  44. (Single-Shot Agent Prompt)
  45. ```
  46. | Document | Purpose |
  47. |----------|---------|
  48. | **SPECIFICATION.md** | What the project is, features, data model, API surface |
  49. | **IMPLEMENTATION.md** | Tech stack, design patterns, directory structure, schemas |
  50. | **TASKS.md** | Ordered work items, each completable in a single agent session |
  51. | **BRANDING.md** | Name, colors, typography, voice (optional, for user-facing projects) |
  52. | **PROMPT.md** | Self-contained prompt to build the entire project from scratch |
  53. ## Features
  54. - **Interactive tech stack advisor** -- presents options with trade-offs, lets you choose
  55. - **Design pattern recommendations** -- matched to your project's specific needs with code sketches
  56. - **Scales to project size** -- weekend hack gets 15 tasks, enterprise system gets 100+
  57. - **Agent-optimized output** -- every task lists exact files to create/modify with acceptance criteria
  58. - **Pause-and-review flow** -- generates each document, waits for approval before continuing
  59. ## Installation
  60. ### Universal (any agent) via skills CLI
  61. The easiest way to install, works with all [agentskills.io-compatible agents](https://agentskills.io):
  62. ```bash
  63. npx skills add ersinkoc/project-architect
  64. ```
  65. This auto-detects your coding agent and installs to the correct location.
  66. **Install for a specific agent:**
  67. ```bash
  68. npx skills add ersinkoc/project-architect --agent wrongstack
  69. npx skills add ersinkoc/project-architect --agent claude-code
  70. npx skills add ersinkoc/project-architect --agent cursor
  71. npx skills add ersinkoc/project-architect --agent codex
  72. ```
  73. **Install globally (all projects):**
  74. ```bash
  75. npx skills add ersinkoc/project-architect --global
  76. ```
  77. > Repository: [github.com/ersinkoc/project-architect](https://github.com/ersinkoc/project-architect)
  78. ### Claude Code (plugin mode)
  79. Add to your project's `.claude/settings.json`:
  80. ```json
  81. {
  82. "plugins": [
  83. "/absolute/path/to/project-architect"
  84. ]
  85. }
  86. ```
  87. Or add to `~/.claude/settings.json` for global availability.
  88. ### Manual installation (any agent)
  89. Clone the repo and copy/symlink the skill directory into your agent's skills folder:
  90. | Agent | Skills Directory |
  91. |-------|-----------------|
  92. | WrongStack | `.wrongstack/skills/` or `~/.wrongstack/skills/` |
  93. | Claude Code | `.claude/skills/` or `~/.claude/skills/` |
  94. | Cursor | `.cursor/skills/` or `~/.cursor/skills/` |
  95. | GitHub Copilot | `.github/skills/` |
  96. | Codex | `.codex/skills/` |
  97. | Gemini CLI | `.gemini/skills/` |
  98. | OpenCode | `.opencode/skills/` |
  99. | Generic | `.agents/skills/` or `~/.agents/skills/` |
  100. ```bash
  101. # Example: install for WrongStack globally
  102. git clone https://github.com/ersinkoc/project-architect.git
  103. ln -s $(pwd)/project-architect ~/.wrongstack/skills/project-architect
  104. # Example: install for Claude Code globally
  105. ln -s $(pwd)/project-architect ~/.claude/skills/project-architect
  106. # Example: install for Cursor in a project
  107. ln -s $(pwd)/project-architect .cursor/skills/project-architect
  108. ```
  109. ## Usage
  110. Start a conversation with your coding agent and describe what you want to build:
  111. ```
  112. > plan my project: a CLI tool for managing dotfiles across machines
  113. ```
  114. Or use any of these trigger phrases:
  115. - "plan my project"
  116. - "spec this out"
  117. - "architect a system for..."
  118. - "help me plan"
  119. - "what stack should I use"
  120. - "generate a prompt"
  121. - "break this into tasks"
  122. - "I want to build X"
  123. ## Workflow
  124. 1. **Discovery** -- Agent asks structured questions about your project (type, scope, stack, features)
  125. 2. **SPECIFICATION.md** -- Generated and presented for review
  126. 3. **IMPLEMENTATION.md** -- Tech decisions, patterns, directory structure
  127. 4. **TASKS.md** -- Ordered work breakdown with file lists and acceptance criteria
  128. 5. **BRANDING.md** -- Optional identity guide (colors, typography, voice)
  129. 6. **PROMPT.md** -- Everything synthesized into a single executable prompt
  130. You review and approve each document before the next is generated.
  131. ## Partial Workflows
  132. You don't have to run the full pipeline:
  133. | What You Say | What Happens |
  134. |-------------|-------------|
  135. | "Just the spec" | Generates SPECIFICATION.md only |
  136. | "Skip to tasks" | Lightweight spec + impl, then detailed tasks |
  137. | "Just give me a prompt" | Condensed discovery, straight to PROMPT.md |
  138. | "Help me choose a stack" | Interactive tech stack selection only |
  139. | "What patterns should I use?" | Design pattern consultation |
  140. ## Reference Files
  141. The skill includes detailed guides that inform each generation phase:
  142. | File | Purpose |
  143. |------|---------|
  144. | `references/elicitation-guide.md` | Question framework for project discovery |
  145. | `references/tech-stacks.md` | Interactive tech stack selection with trade-offs |
  146. | `references/design-patterns.md` | Pattern catalog with selection guide |
  147. | `references/specification-guide.md` | Template and rules for SPECIFICATION.md |
  148. | `references/implementation-guide.md` | Template and rules for IMPLEMENTATION.md |
  149. | `references/tasks-guide.md` | Template and rules for TASKS.md |
  150. | `references/branding-guide.md` | Template and rules for BRANDING.md |
  151. | `references/agent-prompt.md` | Template and rules for PROMPT.md |
  152. ## Project Structure
  153. ```
  154. project-architect/
  155. ├── SKILL.md # Skill definition (agentskills.io format)
  156. ├── plugin.json # Claude Code plugin manifest
  157. ├── LICENSE # MIT License
  158. ├── README.md # This file
  159. └── references/
  160. ├── elicitation-guide.md # Discovery question framework
  161. ├── tech-stacks.md # Tech stack advisor
  162. ├── design-patterns.md # Pattern catalog
  163. ├── specification-guide.md # Spec template
  164. ├── implementation-guide.md # Implementation template
  165. ├── tasks-guide.md # Tasks template
  166. ├── branding-guide.md # Branding template
  167. └── agent-prompt.md # Prompt template
  168. ```
  169. ## Compatibility
  170. This skill follows the [Agent Skills specification](https://agentskills.io/specification) and is compatible with:
  171. - **WrongStack** (terminal-native AI coding agent — [wrongstack.com](https://wrongstack.com))
  172. - **Claude Code** (plugin + skill)
  173. - **Cursor**
  174. - **GitHub Copilot**
  175. - **OpenAI Codex**
  176. - **Gemini CLI**
  177. - **OpenCode**
  178. - **Kiro**
  179. - **And 30+ more agents** via [agentskills.io](https://agentskills.io)
  180. ## License
  181. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.