flow-architect

Automates architectural decision documentation in PLAN.md during brainstorming sessions.

38|4|Updated Oct 1, 2025
One-click install
npx skills add https://github.com/khgs2411/flow --skill flow-architect
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: flow-architect
Source: https://github.com/khgs2411/flow/tree/main/framework/skills/flow-architect
Command: npx skills add https://github.com/khgs2411/flow --skill flow-architect

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams capture and document architectural decisions during brainstorming sessions using Flow framework projects. It ensures architectural rationale, DO/DON'T guidelines, and scope boundaries are preserved in PLAN.md for future reference, reducing rework during implementation.

Core Features & Use Cases

  • Documentation of Architecture: Capture system structure, component responsibilities, data flow, and integration points in PLAN.md.
  • DO/DON'T Guidelines: Propose discovered patterns and anti-patterns with rationale; used to ensure consistent practices across projects.
  • Scope & Technology Decisions: Record scope boundaries and technology choices during brainstorming to avoid scope creep.

Quick Start

Draft an architectural decision and capture it in PLAN.md. Example: Update the Architecture section to adopt an Event-Driven pattern for user events.

Frequently Asked Questions about flow-architect

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

FAQPage Schema
How do I document architectural decisions in PLAN.md during brainstorming?

Document architectural decisions by capturing system structure, component responsibilities, and data flow directly into PLAN.md's Architecture section during brainstorming. This Skill automates the process, guiding you to record design patterns, technology choices, and rationale in consistent format for future reference and implementation traceability.

What are DO/DON'T guidelines and how do I establish them for my project?

DO/DON'T guidelines are discovered patterns and anti-patterns with documented rationale that ensure consistent practices across your project. This Skill helps you propose and capture these guidelines in PLAN.md during architecture discussions, preventing rework and maintaining alignment across the team.

How do I prevent scope creep when planning architecture?

Record scope boundaries and technology choices explicitly in PLAN.md during brainstorming using this Skill. Documenting these decisions upfront creates a reference point for the team, reducing scope creep and ensuring implementation stays aligned with planned architecture.

Can I use this Skill with Flow framework projects?

Yes, this Skill is designed for Flow framework projects. It automates PLAN.md documentation during architecture brainstorming sessions, applying specifically to discussions about architecture, design patterns, technology choices, and scope definitions within the Flow workflow.

Why should I document architecture rationale instead of just implementation code?

Documenting architectural rationale in PLAN.md preserves decision context and traceability that code alone cannot capture. This record helps future developers understand why specific patterns and technologies were chosen, reduces rework, and ensures consistent architectural decisions across team implementations.