Platonic Coding Workflow

Orchestrate the complete five-phase Platonic Coding workflow from conceptual design through specification, implementation guide, code, and review.

When to Use This Skill

Use this skill when you need to:

• Run the full workflow from design idea to reviewed implementation
• Progress through phases with clear phase visibility and handoffs
• Ensure traceability from design draft → RFC → impl guide → code → review
• Coordinate other skills (platonic-code-specs, platonic-impl-guide, platonic-code-review) in the correct order

Keywords: workflow, platonic coding, design draft, RFC, implementation guide, code review, phase

Phase Visibility

Always show the current Phase of the workflow at the start of each step and in summaries:

• Phase 0: Conceptual Design & Design Draft
• Phase 1: RFC Specification (Draft)
• Phase 2: Implementation Guide
• Phase 3: Code Implementation
• Phase 4: Spec Compliance Review
• FINISHED: Workflow complete

Workflow Summary

Phase Details

Phase 0: Conceptual Design & Design Draft

• Goal: Obtain a shared conceptual design (principles, constraints, conceptual interfaces, design art, etc.).
• Method: Interactive chat; use optional items to communicate with the user.
• Output: A design draft.
• Location: Default docs/drafts/. The user may provide a draft from elsewhere.
• Reference: See references/phase-0-design-draft.md.

Phase 1: RFC Specification (Draft)

• Goal: Turn the design draft into a formal RFC spec (Status: Draft).
• Optional: Ask the user for RFC number/index if not specified.
• Actions:
  1. Generate RFC from the Phase 0 design draft.
  2. Call platonic-code-specs to refine the generated RFC (and related specs).
• Output: RFC(s) in the specs directory.
• Location: Default docs/specs/.
• Reference: See references/phase-1-rfc-spec.md.

Phase 2: Implementation Guide

• Goal: Produce a concrete implementation guide from the RFC spec.
• Optional: Ask the user for RFC number/index for which to create the impl guide.
• Actions: Use platonic-impl-guide to create the implementation guide (per README and skill docs).
• Output: Implementation guide integrated into the project.
• Location: Default docs/impl/.
• Reference: See references/phase-2-impl-guide.md.

Phase 3: Code Implementation

• Goal: Implement the feature in code following the guide and RFCs.
• Actions: Run coding agents to write code according to the implementation guide and specs.
• Output: Source code in the existing codebase.
• Reference: See references/phase-3-implementation.md.

Phase 4: Spec Compliance Review

• Goal: Review implementation against both RFC specs and implementation guides.
• Actions: Call platonic-code-review to review the code implementation and the targeted RFC (specs and impl RFCs).
• Output: Review and compliance report.
• Reference: See references/phase-4-review.md.

FINISHED

• Workflow complete. Summarize outcomes and any follow-up recommendations.

Default Paths

Paths may be overridden by the user.

Available References

See references/REFERENCE.md for detailed phase procedures.

Best Practices

1. Always show current phase at the start of each step and in status summaries.
2. Confirm handoffs: Before leaving a phase, confirm outputs and paths with the user if ambiguous.
3. Ask for indices when useful: In Phase 1 (RFC number) and Phase 2 (RFC for impl guide), ask for index if not provided.
4. Call skills explicitly: Phase 1 → platonic-code-specs (refine); Phase 2 → platonic-impl-guide; Phase 4 → platonic-code-review.
5. Preserve traceability: Keep links between design draft → RFC → impl guide → code in summaries and docs.

Dependencies

• platonic-code-specs: Phase 1 (refine RFCs).
• platonic-impl-guide: Phase 2 (create/update impl guides).
• platonic-code-review: Phase 4 (review code vs specs and impl guides).
• Read/write access to docs/drafts/, docs/specs/, docs/impl/ and codebase as needed.