When is the best time to use Flow Architect?

Activate it during the brainstorming phase when discussing technology stacks, design patterns, system structure, or when you need to define what functionality is in scope for the current version.

How does it update my project?

It primarily updates the PLAN.md file, specifically the Architecture, Scope, and DO/DON'T Guideline sections, ensuring that the design rationale is captured before implementation begins.

Does it help with team consistency?

Yes, by documenting DO/DON'T guidelines with clear rationale and code examples, it creates a living style guide that helps all contributors follow the same architectural patterns.

What is the Flow Architect skill?

Flow Architect is a Claude Code capability that helps developers make and document architectural decisions using the Flow framework's iterative methodology.

What are 'Type B' subjects in this framework?

Type B subjects are documentation-only updates that resolve architectural questions or design decisions in PLAN.md without requiring immediate source code changes.

Flow Architect

Name: Flow Architect
Author: khgs2411

bykhgs2411

•

Productivity & Workflow

Guides architectural decision-making and documents system design within the Flow framework to maintain long-term project clarity.

Flow Architect is a specialized skill for Claude Code designed to bridge the gap between high-level brainstorming and structured documentation. It helps developers capture architectural rationale, define system boundaries, and establish coding guidelines (DO/DON'T rules) directly within a project's PLAN.md file. By focusing on documentation during the design phase rather than implementation, it ensures that technology choices, design patterns, and scope constraints are preserved as a 'source of truth' for the entire development lifecycle, preventing architectural drift and technical debt.

Key Features

01Formalized technology choice documentation including trade-off analysis and alternatives

02Resolution of Type B subjects to finalize architectural decisions during brainstorming

03Establishment of DO/DON'T guidelines with technical rationale and code examples

0436 GitHub stars

05Standardized PLAN.md architecture section updates for system structure and data flow

06Clear definition of MVP scope boundaries versus future version enhancements

Use Cases

01Creating a shared repository of team-wide coding patterns and anti-patterns for consistent development

02Defining system components and module boundaries during the initial project setup

03Evaluating and documenting the choice of third-party libraries, APIs, or database schemas

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add khgs2411/flow flow-architect

For use in Claude.ai and ChatGPT

Download Skill