How does Plan Polish handle different project sizes?

It uses track-aware logic from your INTAKE.md: Track M triggers a Lite Schema (8 sections) for moderate complexity, while Track L triggers a Full Schema (14 sections) for high-risk, complex work.

What is a Technical Design Document (TDD)?

A TDD is a detailed blueprint that describes exactly how a software feature will be implemented, including architecture, data structures, API contracts, and edge cases, serving as a guide for developers or AI agents.

Can I use Plan Polish for simple tasks?

For Track S (small tasks), the skill is designed to be skipped entirely, as simple tasks usually do not require the overhead of a formal Technical Design Document.

What happens if a dependency cannot be verified?

Plan Polish is designed to explicitly mark any unverified facts or library behaviors as 'UNVERIFIED' and provides instructions on how to verify them before proceeding.

Does this skill write the actual implementation code?

No, Plan Polish focuses exclusively on the design phase. It ensures the plan is 'air-tight' so that subsequent coding agents can work with zero guesswork.

Plan Polish

Name: Plan Polish
Author: quantfiction

byquantfiction

0•

生産性とワークフロー

Converts rough project concepts into implementation-ready Technical Design Documents optimized for autonomous coding agents.

Plan Polish acts as a Principal Software Architect within your development environment, bridging the gap between initial brainstorming and final implementation. It systematically analyzes rough plans, research dossiers, and repository context to generate air-tight Technical Design Documents (TDDs) that minimize guesswork for autonomous agents. By enforcing track-aware schemas—Lite for medium tasks and Full for complex projects—it ensures that every dependency, API signature, and edge case is verified before a single line of production code is written.

主な機能

01Deep codebase integration analysis to maintain architectural patterns

020 GitHub stars

03Automated Technical Design Document (TDD) generation with YAML frontmatter

04Track-aware schema selection (Lite vs. Full) based on project complexity

05Rigorous dependency and API surface verification gates

06Comprehensive edge case and error taxonomy enumeration

ユースケース

01Architecting complex feature additions for autonomous agent execution

02Formalizing rough brainstormed ideas into structured development roadmaps

03Performing deep dependency and API audits before large-scale refactors

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add quantfiction/dotfiles plan-polish

For use in Claude.ai and ChatGPT

Download Skill