{"id":51090651,"url":"https://github.com/itsyasirkhandev/spec-driven-development","last_synced_at":"2026-06-24T01:33:03.456Z","repository":{"id":355034852,"uuid":"1215870538","full_name":"itsyasirkhandev/spec-driven-development","owner":"itsyasirkhandev","description":"All AI agentic development workflow I use myself and found helpful","archived":false,"fork":false,"pushed_at":"2026-06-02T13:36:07.000Z","size":584,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-02T15:23:53.868Z","etag":null,"topics":["agent-skills","ai-agents","ai-workflows","subagents"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/itsyasirkhandev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-20T10:34:53.000Z","updated_at":"2026-06-02T13:37:24.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/itsyasirkhandev/spec-driven-development","commit_stats":null,"previous_names":["itsyasirkhandev/spec-driven-development"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/itsyasirkhandev/spec-driven-development","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itsyasirkhandev%2Fspec-driven-development","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itsyasirkhandev%2Fspec-driven-development/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itsyasirkhandev%2Fspec-driven-development/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itsyasirkhandev%2Fspec-driven-development/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/itsyasirkhandev","download_url":"https://codeload.github.com/itsyasirkhandev/spec-driven-development/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itsyasirkhandev%2Fspec-driven-development/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34713789,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-23T02:00:07.161Z","response_time":65,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-skills","ai-agents","ai-workflows","subagents"],"created_at":"2026-06-24T01:33:03.358Z","updated_at":"2026-06-24T01:33:03.445Z","avatar_url":"https://github.com/itsyasirkhandev.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Spec-Driven Development (SDD) Framework\n\n\u003e A robust, AI-native framework for high-velocity software engineering, prioritizing technical clarity and execution excellence.\n\nThis repository defines the core methodology, agents, and specialized skills that power a **Spec-Driven Development** workflow. By separating \"what\" from \"how,\" and \"how\" from \"implementation,\" we ensure that every line of code serves a verified purpose.\n\n---\n\n## 🚀 Core Methodology: The SDD Workflow\n\nThe framework follows a strict, sequential pipeline to minimize rework and maximize code quality:\n\n```mermaid\ngraph LR\n    A[Spec] --\u003e B[Review]\n    B --\u003e C[Design]\n    C --\u003e D[Review]\n    D --\u003e E[Tasks]\n    E --\u003e F[Build]\n    F --\u003e G[Validate]\n```\n\n1.  **Spec Phase**: Define requirements. (See [spec driven development.md](./spec%20driven%20development.md) and [example-spec.txt](./example-spec.txt))\n2.  **Review Phase**: Rigorous validation of the Spec or Design.\n3.  **Design Phase**: Technical architecture. (See [example-designmd.txt](./example-designmd.txt))\n4.  **Tasks Phase**: Granular task breakdown. (See [creating-tasks.txt](./creating-tasks.txt))\n5.  **Build Phase**: The actual coding phase, where features are implemented following the task list.\n6.  **Validate Phase**: Ensuring the implementation meets all acceptance criteria.\n\n---\n\n## 🤖 AI Agents \u0026 Subagents\n\nThe framework utilizes a fleet of specialized subagents, each optimized for a specific phase of the SDD lifecycle:\n\n| Agent | Role | Definition File |\n| :--- | :--- | :--- |\n| **Spec Specialist** | Feature Definition | [spec.md](./GEMINI%20CLI%20sub%20agents/agents/spec.md) |\n| **Architect (Design)** | Technical Design | [design.md](./GEMINI%20CLI%20sub%20agents/agents/design.md) |\n| **Task Decomposer** | Planning | [create-tasks.md](./GEMINI%20CLI%20sub%20agents/agents/create-tasks.md) |\n| **Code Reviewer** | Quality Control | [code-reviewer.md](./GEMINI%20CLI%20sub%20agents/agents/code-reviewer.md) |\n| **UI Designer** | Visual Excellence | [ui-designer.md](./GEMINI%20CLI%20sub%20agents/agents/ui-designer.md) |\n| **Tech Expert** | Deep Research | [tech-expert.md](./GEMINI%20CLI%20sub%20agents/agents/tech-expert.md) |\n| **TypeScript Pro** | Implementation | [typescript-pro.md](./GEMINI%20CLI%20sub%20agents/agents/typescript-pro.md) |\n| **README Generator** | Documentation | [readme-generator.md](./GEMINI%20CLI%20sub%20agents/agents/readme-generator.md) |\n| **Search Specialist** | Discovery | [search-specialist.md](./GEMINI%20CLI%20sub%20agents/agents/search-specialist.md) |\n\n---\n\n## 🛠️ Specialized Skills\n\nSkills are bundled instruction sets and resources that extend agent capabilities:\n\n*   **[`fallow`](./skills/fallow/SKILL.md)**: Static analysis for dead code and complexity management.\n*   **[`vercel-react-best-practices`](./skills/vercel-react-best-practices/SKILL.md)**: Performance optimization for Next.js/React.\n*   **[`write-a-skill`](./skills/write-a-skill/SKILL.md)**: The meta-skill for creating new capabilities.\n\n---\n\n## 🧠 Context Management\n\nWe maintain a multi-layered context system to ensure AI agents operate with consistent rules and philosophies:\n\n*   **Global Context**: [AGENTS_MD/global/GEMINI.md](./AGENTS_MD/global/GEMINI.md) - System-wide rules for languages and standards.\n*   **Project Context**: [AGENTS_MD/project/GEMINI.md](./AGENTS_MD/project/GEMINI.md) - Repository-specific guidelines and philosophies.\n*   **Knowledge Items (KIs)**: Curated, localized knowledge about the repository to avoid redundant research and adhere to established patterns.\n\n---\n\n## 📐 Design Philosophy: \"Fire Your Design Team\"\n\nIntegrated into the design phase are premium aesthetic guidelines (tailored for shadcn/ui and Tailwind v4) defined in [DESIGN_GUIDELINES.md](./Fire%20Your%20Design%20Team/DESIGN_GUIDELINES.md):\n\n*   **Typography**: Strictly **4 font sizes** and **2 weights** (Regular/Semibold) for maximum clarity.\n*   **Grid System**: A rigorous **8pt grid** (all spacing divisible by 8 or 4).\n*   **Color Distribution**: The **60/30/10 rule** (60% neutral, 30% complementary, 10% accent).\n*   **Aesthetics**: Vibrant colors, glassmorphism, and modern typography (Inter, Outfit).\n\n---\n\n## ⌨️ How to Use\n\n1.  **Initialize**: Pull latest from `main`, create a feature branch.\n2.  **Spec**: Use the **Spec Specialist** agent (or `/spec` command) to define requirements.\n3.  **Review**: Ask the AI to review the spec against edge cases.\n4.  **Design**: Use the **Architect** agent to create `design.md`.\n5.  **Tasks**: Use the **Task Decomposer** to generate a phased `tasks.md` with To-Dos.\n6.  **Build**: Hand off tasks to implementation agents in chunks.\n7.  **Validate**: Verify against the original acceptance criteria.\n8.  **Ship**: Commit, Push, PR, Merge, and Delete branch.\n\n\n## 📂 Repository Structure\n\n```text\n.\n├── AGENTS_MD/               # Global and Project-level AI context/rules\n├── Fire Your Design Team/   # Premium UI/UX design guidelines\n├── GEMINI CLI sub agents/   # Specialized agent instructions (markdown)\n├── skills/                  # Core skill definitions and resources\n├── spec driven development.md # Detailed methodology documentation\n└── ...                      # Example specs, designs, and task lists\n```\n\n---\n\n*This framework is designed for developers who want to move faster while building higher-quality, more maintainable software.*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fitsyasirkhandev%2Fspec-driven-development","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fitsyasirkhandev%2Fspec-driven-development","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fitsyasirkhandev%2Fspec-driven-development/lists"}