project-architect

Plans greenfield project architecture and generates standardized READMEs through guided approval steps.

Updated Jun 19, 2026
One-click install
npx skills add https://github.com/MatheusFelipeCorrea/Agrofarm --skill project-architect-matheusfelipecorrea
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-architect
Source: https://github.com/MatheusFelipeCorrea/Agrofarm/tree/main/.github/skills/project-architect
Command: npx skills add https://github.com/MatheusFelipeCorrea/Agrofarm --skill project-architect-matheusfelipecorrea

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Starting a new software project from scratch often leads to inconsistent architecture decisions, missing documentation, and mismatched frontend/backend designs. This Skill guides you through a structured planning process that produces a coherent architecture and production-ready READMEs for frontend, backend, and database. ## Core Features & Use Cases - Guided Architecture Planning: Walks through project understanding, architecture pattern selection, tech stack suggestion, screen/UX ideas, database design, and endpoint design — each with explicit human approval gates. - Standardized README Generation: Produces detailed READMEs with emoji section headers, ASCII folder trees, layer responsibility descriptions, data flow diagrams, route listings, and environment variable blocks, adapted to monorepo, fullstack, backend-only, or frontend-only setups. - Stack-Agnostic Adaptation: Adjusts patterns, SQL dialects, and documentation format to any technology stack and database provider (PostgreSQL, MySQL, MongoDB, SQLite, Firebase, Supabase, and others). - Use Case: A student team starting a farm management system describes their requirements, receives a suggested React + Express + PostgreSQL architecture with folder structure and database schema, approves each step, and gets three consistent READMEs ready to commit. ## Quick Start Ask the assistant to plan the architecture for your new project by describing its objective, target audience, core features, and preferred technologies.

Frequently Asked Questions about project-architect

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

FAQPage Schema
How do I plan architecture for a new software project?

Provide the project name, objective, target audience, core features, and tech preferences. The skill then walks you through architecture pattern selection, tech stack suggestion, screen design, database schema, and endpoint design, asking for approval before each step.

What should a project README include for frontend and backend?

The generated READMEs include a technology table, ASCII folder tree, per-layer responsibility descriptions, data flow diagrams, route listings grouped by access level, run instructions, scripts table, and environment variable blocks. Backend READMEs also cover business rules and error response patterns.

Does it support databases other than PostgreSQL?

Yes, it adapts database design to MySQL, MongoDB, SQLite, Firebase, Supabase, PlanetScale, Neon, and other providers. SQL output is adjusted per dialect, such as using CREATE TYPE enums for PostgreSQL or document schemas for MongoDB.

Can it work with Figma prototypes or wireframes?

Yes, if you provide prototype images it extracts page names, components, actions, and data requirements, then maps each screen to routes, hooks, and endpoints. Without prototypes, it suggests screen ideas based on your requirements.

When should I not use a guided architecture planner?

It is designed for greenfield projects, so it is not suited for documenting or refactoring existing codebases. Very small single-file scripts also do not benefit from multi-layer architecture planning and README generation.