project-architect

Generates specification, implementation, task, and prompt documents for project planning.

Updated Jul 20, 2026
One-click install
npx skills add https://github.com/idy-00/paytrack --skill project-architect-idy-00
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-architect
Source: https://github.com/idy-00/paytrack/tree/main/backend/.agents/skills/project-architect
Command: npx skills add https://github.com/idy-00/paytrack --skill project-architect-idy-00

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Turning a rough project idea into an actionable build plan requires many decisions about scope, tech stack, architecture, and task breakdown. This Skill runs a structured discovery interview and produces a complete documentation set that a developer or coding agent can execute directly. ## Core Features & Use Cases - Sequential document pipeline: Generates SPECIFICATION.md, IMPLEMENTATION.md, TASKS.md, optional BRANDING.md, and a self-contained PROMPT.md, pausing for review between each. - Interactive tech stack and pattern advisor: Presents language, framework, database, and design pattern options with trade-offs, using structured questions instead of freeform guessing. - Agent-ready output: Produces a single-shot PROMPT.md with exact file lists, dependency versions, code sketches, and acceptance criteria for autonomous execution by coding agents. - Use Case: Describe "a CLI tool for managing dotfiles across machines" and receive a full specification, an implementation blueprint with a directory tree, an ordered task list, and a prompt you can hand to any coding agent to build it. ## Quick Start Ask your coding agent to plan my project and describe the application you want to build in one or two sentences.

Frequently Asked Questions about project-architect

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I plan a software project with an AI coding agent?

Describe your project idea and trigger the planning workflow with phrases like "plan my project" or "spec this out". The skill runs a structured discovery interview, then generates SPECIFICATION.md, IMPLEMENTATION.md, TASKS.md, and a self-contained PROMPT.md, pausing for your approval between documents.

What documents does a documentation-first project planning workflow produce?

It produces five interconnected Markdown files: SPECIFICATION.md defining what to build, IMPLEMENTATION.md defining how to build it, TASKS.md with ordered work items, optional BRANDING.md for identity, and PROMPT.md synthesizing everything into a single-shot agent prompt.

How do I choose a tech stack for a new project?

Say "help me choose a stack" to run the interactive stack advisor. It presents language, framework, database, ORM, auth, and deployment options with trade-offs as structured multiple-choice questions, and recommends complete stack templates for common project types.

Can I generate only a specification or only tasks instead of the full pipeline?

Yes, partial workflows are supported. Say "just the spec" for SPECIFICATION.md only, "skip to tasks" for a lightweight spec plus detailed tasks, or "just give me a prompt" to go straight to PROMPT.md generation.

Which coding agents are compatible with this skill?

It works with any agent that supports file read/write and user interaction, including WrongStack, Claude Code, Cursor, GitHub Copilot, Codex, Gemini CLI, and other agentskills.io-compatible agents. The generated PROMPT.md is portable across agents.

When should I not use a single-shot agent prompt for a project?

Very large projects exceeding roughly 30,000 words of prompt content should be split into multiple self-contained prompts, such as foundation, features, and release phases. The skill's prompt guide defines size thresholds and splitting rules.