Why does this skill emphasize ASCII diagrams?

ASCII diagrams provide a text-based, version-control-friendly way for AI agents to communicate architectural changes and component relationships directly within the terminal.

How does the validation process work?

The skill includes a 'write' command that automatically checks for required sections like Summary and Deliverables, ensuring the document is correctly formatted before it is saved.

What is a solution outline in the Plan Marshall context?

A solution outline is a structured Markdown document that defines the technical approach, architectural overview, and specific deliverables for a task before implementation begins.

Can this skill be used for existing projects?

Yes, it is designed to work with existing projects by loading architectural context via the analyze-project-architecture skill to ensure new designs fit the current system.

What happens if validation fails?

If the solution outline fails to meet the required structural standards or deliverable formatting, the skill will block the write operation and provide specific feedback on what needs to be fixed.

Solution Outline Manager

Name: Solution Outline Manager
Author: cuioss

bycuioss

0•

Productivity & Workflow

Standardizes and validates technical solution designs with ASCII diagrams and structured deliverables for AI-driven development.

The manage-solution-outline skill provides a structured framework for creating, validating, and managing solution documents within the Plan Marshall orchestration layer. It ensures that AI coding assistants like Claude generate predictable, high-quality technical plans by enforcing specific sections such as architecture overviews, ASCII-based flow diagrams, and sequential deliverables. By integrating architectural context from the project, this skill helps developers and AI agents bridge the gap between high-level requirements and executable code tasks while maintaining strict document standards.

Key Features

01Extracts structured deliverable lists for seamless task generation

02Enforces standardized Markdown structure for technical solution documents

03Provides specialized ASCII diagram patterns for features, refactors, and bug fixes

04Automates validation of required sections and sequential deliverable formatting

05Integrates with project architecture metadata to ensure design consistency

060 GitHub stars

Use Cases

01Creating 'Before vs. After' transformation diagrams for large-scale refactoring tasks

02Architecting complex features with visual component relationships before writing code

03Validating AI-generated implementation plans to ensure they meet project-specific standards

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add cuioss/plan-marshall manage-solution-outline

For use in Claude.ai and ChatGPT

Download Skill