skill-product-solution-blueprint

# Solution Blueprinting ## 1. Objective To translate abstract "Vision" into concrete "Requirements" without writing code. This skill powers the **Solution Architect (p04)** agent. ## 2. Text-Based UX Flows (The "Skeleton") **Constraint:** Do NOT use Mermaid graphs for detailed logical flows. Use text lists. ### Template > **[Use the Official Template](assets/solution_blueprint_template.md)** for the full structure. ### Syntax Example ```markdown ### Flow 1: [User Story Name] - **Size:** M (60h) | **LLM Friendly:** 0.8 1. User [Action] on [Page/Component]. - *System:* [Validates/Checks/Loads]. - *Error Path:* If [Condition], show [Error Message]. 2. User sees [Result]. ``` ## 3. Business Case (Enhanced ROI) ### Logic Locker (CRITICAL) > [!IMPORTANT] > **FORBIDDEN ACTION:** You are **strictly forbidden** from calculating ROI/NPV manually. > You MUST first list all User Stories with sizes + friendliness, then run the script. ### Protocol 1. **Estimate**: For each user story, assign a Size (XS, S, M, L, XL) and LLM Friendliness (0.0 - 1.0). 2. **Prepare**: Create a temp JSON file in `docs/product/` (e.g., `docs/product/stories.json`): ```json { "stories": [ { "name": "Login", "size": "S", "llm_friendly": 0.9 }, { "name": "Complex Dashboard", "size": "L", "llm_friendly": 0.3 } ] } ``` 3. **Execute**: ```bash # Usage: python3 [skill_path]/scripts/calculate_roi.py --file docs/product/stories.json --users <SOM> --price <PRICE> ...