skills.rest
Pionpill
PionpillCOMMUNITY
Explore all skills by this author →
Website𝕏@pionpillGitHub

develop-design

Drafts alpha-feature ADRs with schema, scope, and test-quadrant specifications.

12|2|Updated Nov 27, 2024
Search Tags:#schema design#adr#ai-friendly#feature planning#tikz#testing matrix#d3-react
One-click install
npx skills add https://github.com/Pionpill/retikz --skill develop-design
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: develop-design
Source: https://github.com/Pionpill/retikz/tree/main/.agents/skills/develop-design
Command: npx skills add https://github.com/Pionpill/retikz --skill develop-design

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

develop-design turns a one-sentence alpha feature idea into a complete ADR draft that downstream agents can implement, test, and document without guessing the schema, file scope, or required test coverage.

Core Features & Use Cases

  • Produce an ADR proposal for an alpha feature: creates a structured ADR (including DSL surface and testing design) that defines how the feature should work.
  • Enforce AI-friendly schema and naming rules: ensures the proposed IR schema is JSON-serializable, uses TikZ-like field names (no cryptic abbreviations), and follows strict discriminated-union conventions via a checklist aligned to DESIGN.md.
  • Define a mandatory implementation contract: includes Level (red/yellow/green), a schema-change table, an explicit file scope whitelist, and a test-quadrant plan with at least 9 cases, plus declared dependencies on existing elements.

Quick Start

Ask an AI to act as the ADR drafter for your alpha feature, then require it to produce a Proposed ADR draft that includes the full implementation contract sections and an AI-friendly schema.

Frequently Asked Questions about develop-design

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

FAQPage Schema
How do I draft an AI-friendly ADR for schema design?▼

An AI-friendly ADR enforces a JSON-serializable IR schema with TikZ-like field names and discriminated-union conventions. It includes a hard implementation contract so downstream agents can implement the feature deterministically.

What is a test quadrant plan and how many cases do I need for an ADR?▼

A test quadrant plan is a mandatory validation matrix defined within an ADR. You need a minimum of 9 test cases in the quadrant to satisfy validation completeness before transitioning to implementation.

How do I translate TikZ gap analysis priorities into an ADR?▼

You translate TikZ gap analysis priorities into an ADR by mapping the semantics into a DSL surface and decision rationale. The ADR then defines the required schema changes and file scope whitelist.

Can I use an ADR to define file scope and implementation levels for AI agents?▼

Yes, an ADR defines an explicit file scope whitelist and assigns implementation Levels (red, yellow, green). This contract prevents AI agents from guessing boundaries during execution.

What are the limitations of using a hardcoded schema in an ADR for feature planning?▼

Without strict discriminated-union conventions, a schema limits multi-LLM evaluation handling. The ADR requires a JSON-serializable schema aligned to design checklists to ensure validation completeness.

Related Skills

Explore More Design & Creative Skills→
cano721cano721

brainstorm-ideas-existing

Generate and prioritize product ideas from PM, Designer, and Engineer perspectives.

Community
Advanced
patricio0312revpatricio0312rev
5

api-test-suite-generator

Generate API test suites from route definitions for Express, Next.js, and Fastify.

Community
Advanced
PionpillPionpill
12

docs-doc-blog

Generate retikz blog MDX content with strict structure and ComponentPreview.

Community
Advanced
thapaliyabikendrathapaliyabikendra
24

technical-design-patterns

Create technical design documents for ABP Framework features.

Community
Basic