architect-agent-skill

Generate PRDs with database context and Zod schemas across a six-phase workflow.

Updated Sep 29, 2025
One-click install
npx skills add https://github.com/fercracix33/poli2-clean-architecture --skill architect-agent-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architect-agent-skill
Source: https://github.com/fercracix33/poli2-clean-architecture/tree/main/.claude/skills/architect-agent-skill
Command: npx skills add https://github.com/fercracix33/poli2-clean-architecture --skill architect-agent-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill eliminates architectural ambiguity and technical debt by providing a structured 6-phase workflow for technical specification and agent coordination.

Core Features & Use Cases

  • Database Context Research: Automatically queries existing schema patterns before design.
  • PRD Generation: Creates comprehensive 14-section product requirements documents.
  • Use Case: When tasked with designing a new feature like "task comments," use this Skill to ensure proper multi-tenancy, RLS policies, and entity design.
  • Agent Coordination: Manages parallel work through structured handoffs and iteration reviews.

Quick Start

Use the architect-agent-skill to design a complete technical specification for adding comments to tasks, including Zod schemas, API specs, and RLS policies.

Frequently Asked Questions about architect-agent-skill

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

FAQPage Schema
How do I create a PRD with database schema validation using Zod?

This Skill automates PRD creation by first querying your existing database schema, then generates a comprehensive 14-section product requirements document that includes Zod schemas for entity validation. It ensures your PRD aligns with actual database patterns and multi-tenant constraints before implementation.

What's the best way to design multi-tenant RLS policies for new database features?

This Skill guides you through a structured 6-phase workflow that includes database context research, clarification dialogue, and entity design with RLS-aware patterns. It produces validated schemas, RLS policies, and handoff templates ready for agent coordination and iteration.

How do I ensure clean architecture in technical specification and agent handoffs?

The Skill enforces clean architecture by automating specification across six phases—pre-discovery research through iteration reviews—with mandatory database context. It delivers iteration-ready templates, validated data contracts, and structured coordination points that eliminate architectural ambiguity.

Can I use this for designing features like task comments with proper data contracts?

Yes. Provide the feature description, and the Skill automates the complete workflow: researching existing schema, generating functional and technical requirements, producing Zod schemas for create/update/query operations, and designing RLS policies specific to your multi-tenant model.

What technical deliverables does the PRD workflow include?

The Skill produces 14-section PRDs, Zod schemas for data validation, API specifications, RLS policy designs for multi-tenant databases, and iteration-ready handoff templates. All outputs reference validated database patterns extracted from your existing schema context.