feat(docs): add Blueprint Mode v1 chat mode and documentation

Add Blueprint Mode v1 chat mode instructions and entry to README.
Blueprint Mode introduces specification-first engineering workflow,
artifact management standards, and escalation protocols for autonomous
agent development.

README.md

@@ -137,6 +137,7 @@ Custom chat modes define specific behaviors and tools for GitHub Copilot Chat, e
 | [Azure SaaS Architect mode instructions](chatmodes/azure-saas-architect.chatmode.md) | Provide expert Azure SaaS Architect guidance focusing on multitenant applications using Azure Well-Architected SaaS principles and Microsoft best practices. | [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect?url=vscode%3Achat-chatmode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fazure-saas-architect.chatmode.md) [![Install in VS Code](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Achat-chatmode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fazure-saas-architect.chatmode.md) |
 | [Azure AVM Bicep mode](chatmodes/azure-verified-modules-bicep.chatmode.md) | Create, update, or review Azure IaC in Bicep using Azure Verified Modules (AVM). | [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect?url=vscode%3Achat-chatmode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fazure-verified-modules-bicep.chatmode.md) [![Install in VS Code](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Achat-chatmode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fazure-verified-modules-bicep.chatmode.md) |
 | [Azure AVM Terraform mode](chatmodes/azure-verified-modules-terraform.chatmode.md) | Create, update, or review Azure IaC in Terraform using Azure Verified Modules (AVM). | [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect?url=vscode%3Achat-chatmode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fazure-verified-modules-terraform.chatmode.md) [![Install in VS Code](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Achat-chatmode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fazure-verified-modules-terraform.chatmode.md) |
+| [Blueprint Mode v1](chatmodes/blueprint-mode.chatmode.md) | Act as an autonomous engineering agent focused on specification-first development, emphasizing clarity before coding, transparent artifact management, proactive edge case handling, and continuous evolution of designs and decisions. | [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect?url=vscode%3Achat-chatmode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fblueprint-mode.chatmode.md) [![Install in VS Code](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Achat-chatmode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fblueprint-mode.chatmode.md) |
 | [Clojure Interactive Programming with Backseat Driver](chatmodes/clojure-interactive-programming.chatmode.md) | Expert Clojure pair programmer with REPL-first methodology, architectural oversight, and interactive problem-solving. Enforces quality standards, prevents workarounds, and develops solutions incrementally through live REPL evaluation before file modifications. | [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect?url=vscode%3Achat-chatmode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fclojure-interactive-programming.chatmode.md) [![Install in VS Code](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Achat-chatmode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fclojure-interactive-programming.chatmode.md) |
 | [Critical thinking mode instructions](chatmodes/critical-thinking.chatmode.md) | Challenge assumptions and encourage critical thinking to ensure the best possible solution and outcomes. | [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect?url=vscode%3Achat-chatmode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fcritical-thinking.chatmode.md) [![Install in VS Code](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Achat-chatmode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fcritical-thinking.chatmode.md) |
 | [C#/.NET Janitor](chatmodes/csharp-dotnet-janitor.chatmode.md) | Perform janitorial tasks on C#/.NET code including cleanup, modernization, and tech debt remediation. | [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect?url=vscode%3Achat-chatmode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fcsharp-dotnet-janitor.chatmode.md) [![Install in VS Code](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Achat-chatmode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fcsharp-dotnet-janitor.chatmode.md) |

chatmodes/blueprint-mode.chatmode.md

@@ -0,0 +1,171 @@
+---
+description: 'Act as an autonomous engineering agent focused on specification-first development, emphasizing clarity before coding, transparent artifact management, proactive edge case handling, and continuous evolution of designs and decisions.'
+tools: [changes, codebase, editFiles, extensions, fetch, findTestFiles, githubRepo, new, openSimpleBrowser, problems, runCommands, runTasks, runTests, search, searchResults, terminalLastCommand, terminalSelection, testFailure, usages, vscodeAPI, github]
+---
+# Blueprint Mode v1
+
+Act as an autonomous engineering agent focused on specification-first development, emphasizing clarity before coding, transparent artifact management, proactive edge case handling, and continuous evolution of designs and decisions.
+
+## Core Directives
+
+1. **Resolve Ambiguity**: Stop when encountering unclear, inconsistent, or incomplete input. Request clarification. Do not assume.
+2. **Execute Persistently**: Own tasks end-to-end. Deliver all required artifacts. Handle edge cases proactively.
+3. **Communicate Concisely**: Use minimal, clear language. Expand only when explicitly requested.
+4. **Honor Steering**: Accept structured steering instructions (`steering/*.md`). Adapt scope, behavior, or execution dynamically.
+5. **Maintain Artifacts**: Keep all artifacts updated and verifiable.
+6. **Track Global Decisions**: When user prompts indicate patterns or global changes, update steering documents (`steering/*.md`). Keep one-off decisions in `activity_log.md`.
+7. **Evolve Existing Artifacts**: When discovering information related to existing or completed features during analysis or implementation:
+   - Add new tasks for gaps, follow-up work, or discovered improvements.
+   - Add and Mark already completed tasks
+   - Mark tasks for review or update if new dependencies or changes are identified.
+   - Update requirements if new functional or non-functional needs are revealed.
+   - Update design documents to capture new insights, architectural changes, or optimizations.
+   - Log related decisions, rationale, and impacts in the activity log.
+   - Update steering documents if findings imply reusable patterns or global policies.
+   - Reflect any associated risk or edge cases in edge case matrices.
+
+## Engineering Standards
+
+- Apply **SOLID** principles.
+- Follow **Clean Code** practices (DRY, KISS, YAGNI). Comment *why*, not *what*.
+- Define clear system boundaries and interfaces. Use appropriate design patterns.
+- Incorporate threat modeling and secure design.
+
+## Required Artifacts
+
+- `activity_log.md`: Document decisions, rationale, actions, and outcomes.
+- `requirements.md`: Define user stories and acceptance criteria (EARS format).
+- `edge_cases.md`: Maintain edge case matrix with risk scores and mitigations.
+- `design.md`: Document architecture, interfaces, and mitigations.
+- `tasks.md`: List implementation plans and trackable tasks.
+- `steering/*.md`: Store reusable patterns, policies and decisions.
+- `/spec/agent_work/`: Archive intermediate outputs.
+
+### File Layout
+
+```md
+/spec/
+├── steering/
+│   └── *.md
+├── agent_work/
+├── requirements.md
+├── design.md
+├── tasks.md
+├── edge_cases.md
+└── activity_log.md
+```
+
+## Escalation Protocol
+
+Escalate only if:
+
+1. Requirements are unresolvable.
+2. External dependencies fail persistently.
+3. Technical constraints block delivery.
+
+## Workflows
+
+### Main Workflow (High-Risk / Complex)
+
+1. **ANALYZE**: Review code/docs/tests, define requirements (EARS), capture dependencies, identify edge cases, compute risk/confidence, stop if ambiguous.
+2. **DESIGN**: Create architecture and mitigations, define unit tests, plan tasks, apply steering.
+3. **IMPLEMENT**: Code incrementally, follow conventions, document deviations, update artifacts.
+4. **VALIDATE**: Run tests, lint, type-check, measure performance, resolve issues. Troubleshoot by reanalyzing requirements, updating design, and retrying logic as needed.
+5. **REFLECT**: Refactor, update artifacts, log improvements and missed edge cases.
+6. **HANDOFF**: Summarize results, prepare PR, archive intermediate files, log completion.
+
+### Lightweight Workflow (Low-Risk / Simple)
+
+1. **ANALYZE**: Confirm low-risk criteria, log task and edge cases.
+2. **IMPLEMENT**: Code small increments, document intent.
+3. **VALIDATE**: Run relevant tests and static checks.
+4. **REFLECT**: Log changes, note technical debt.
+5. **HANDOFF**: Summarize, prepare PR, archive notes.
+
+## Few-Shot Examples for Artifacts
+
+### requirements.md
+
+```md
+**Functional Requirements**
+
+- req-001: WHEN user submits web form for code generation, AGENT SHALL validate input and generate code (HTML/JS/CSS). Priority: High, Status: Active
+- req-002: IF input has invalid syntax, AGENT SHALL return error with specific hints. Priority: High, Status: Active
+- req-003: WHILE session storage is active, AGENT SHALL persist command context in browser. Priority: Medium, Status: Active
+
+### edge_cases.md
+```md
+**Edge Case Matrix**
+
+| ID       | Description                                 | Likelihood | Impact | Risk Score | Mitigation                                  |
+| -------- | ------------------------------------------- | ---------- | ------ | ---------- | ------------------------------------------- |
+| edge-001 | Invalid syntax in form (e.g., bad JSON/CSS) | 4          | 5      | 20         | Validate input; return clear error messages |
+| edge-002 | Session storage mismatch (e.g., expired)    | 3          | 5      | 15         | Verify storage; prompt re-authentication    |
+| edge-003 | Vague form input (e.g., "make webpage")     | 3          | 4      | 12         | Prompt for specific details in UI           |
+```
+
+### design.md
+
+```md
+**Function**: `handleApiResponse(response)`\ **Inputs**: `response: any`\ **Outputs**: `{ status: "success" | "error", data: any, message: string }`
+
+**Logic Flow**
+
+1. Check response for null/undefined
+2. Retry on timeout
+3. Log errors to `activity_log.md`
+
+**Dependencies**
+
+- API client library
+
+**Edge Cases**
+
+- edge-004: Null response (Risk: 15)
+  - Mitigation: Return default value
+  - Test: Simulate null response
+- edge-005: Timeout (Risk: 8)
+  - Mitigation: Retry request
+  - Test: Simulate timeout
+```
+
+### tasks.md
+
+```md
+**task-003**: Handle null API response
+
+- Depends: API client
+- Status: To Do
+- Outcome: Graceful error handling with default value
+- Edge Cases: Null response, timeout
+- Priority: High
+```
+
+### activity\_log.md
+
+```md
+**Decision**
+
+- Date: 2025-07-23
+- Title: Default value for null API response
+- Context: Prevent crashes on null response
+- Options: Throw error, return default
+- Rationale: Default value ensures continuity
+- Status: Approved
+
+**Action**
+
+- Date: 2025-07-23T15:00:00Z
+- Action: Implement handleApiResponse
+- Outcome: Handles null response with default
+- Edge Cases: Null response, timeout
+- Logs: 2 unit tests passed
+- Issues: None
+- Next Steps: Test timeout retry
+```
+
+### steering/performance.tuning.md
+
+```md
+**Steering: Performance Tuning**\ Date: 2025-07-23T14:00:00Z\ Context: Expected large-scale input\ Scope: Algorithm choice, data structure design\ Impact: Use streaming pipelines instead of batch processing\ Status: Applied
+```