skills.rest
surus-lat
surus-latOFFICIAL
Explore all skills by this author →
Website𝕏@surusdevGitHub

oracle-plan

Convert implementation snapshots to structured oracle-quality design plans and back.

8|Updated Sep 12, 2025
Search Tags:#git#design#tdd#architecture#documentation#refactoring
One-click install
npx skills add https://github.com/surus-lat/benchy --skill oracle-plan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: oracle-plan
Source: https://github.com/surus-lat/benchy/tree/main/.agent/skills/oracle-plan
Command: npx skills add https://github.com/surus-lat/benchy --skill oracle-plan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill solves the disconnect between working code and high-fidelity documentation by providing a standardized, bidirectional algorithm to convert implementations into design plans and vice versa.

Core Features & Use Cases

  • Implementation to Plan: Automatically generate a comprehensive design document from a working branch, capturing architecture decisions, file maps, and known pitfalls.
  • Plan to Implementation: Execute a verified design plan to reconstruct a feature with zero wrong turns, ensuring TDD compliance and architectural integrity.
  • Use Case: Use this when you need to document a complex feature branch for team review or when you need to port a battle-tested feature to a new repository without losing critical implementation context.

Quick Start

Use the oracle-plan skill to extract the design plan from the current working branch and save it as a markdown file.

Frequently Asked Questions about oracle-plan

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

FAQPage Schema
How do I generate architecture documentation from an existing code branch?▼

Generate architecture documentation from a working branch by extracting implementation snapshots into a structured design plan, capturing file maps, architectural decisions, and known pitfalls for comprehensive team review.

What is the best way to port a feature to a new repository without losing implementation context?▼

Porting a feature without losing context requires extracting a structured design plan from the original implementation, then executing that verified plan in the new repository to reconstruct the feature with zero wrong turns.

Can I use TDD compliance to reconstruct a feature from a design plan?▼

Yes, executing a verified design plan to reconstruct a feature ensures TDD compliance and maintains architectural integrity by adhering to defined schema structures for implementation snapshots during the transformation process.

Does converting code to design plans require a specific file structure?▼

Converting code to design plans requires adherence to defined schema structures for implementation snapshots and oracle plans to properly validate quality, verify architecture decisions, and ensure reproducible feature development.

How does bidirectional transformation between code and design documentation work?▼

Bidirectional transformation works by applying a standardized algorithm to convert working code implementations into structured design plans and vice versa, bridging the disconnect between code and high-fidelity documentation.

When should I not use automated design plan generation for refactoring?▼

Avoid automated design plan generation for simple refactoring tasks that do not require high-fidelity documentation, architectural decision tracking, or reproducible feature development, as the schema adherence overhead outweighs the benefits.

Related Skills

Explore More Software Engineering Skills→
HerxinsasaHerxinsasa
1

using-git-worktrees

Creates isolated Git worktrees for parallel branch development without switching.

Community
Intermediate
adolfoaranaes12adolfoaranaes12
2

create-adr

Create Architecture Decision Records with context, alternatives, rationale, and consequences.

Community
Advanced
dogekikidogekiki

overleaf-sync

Synchronize local LaTeX directories with Overleaf projects via Git.

Community
Advanced
EricOo0EricOo0
6

writing-plans

Generate implementation plans specifying files, tests, docs, and commit steps.

Community
Basic