feat: removed some templates that are not ready for use

This commit is contained in:
Brian Madison
2025-06-17 22:04:24 -05:00
parent bc7cc0439a
commit b03aece79e
16 changed files with 802 additions and 2121 deletions

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

View File

@@ -3496,13 +3496,13 @@ After presenting all data models, apply `tasks#advanced-elicitation` protocol]]
**TypeScript Interface:**
````typescript
```typescript
{
{
model_interface;
}
}
```text
```
**Relationships:**
@@ -3542,7 +3542,7 @@ interface UserProfile {
bio?: string;
preferences: Record<string, any>;
}
````
```
**Relationships:**
@@ -3566,7 +3566,7 @@ Use appropriate format for the chosen API style. If no API (e.g., static site),
^^CONDITION: has_rest_api^^
````yml
```yml
openapi: 3.0.0
info:
title:
@@ -3580,7 +3580,7 @@ servers:
'[object Object]': null
description:
'[object Object]': null
```text
```
^^/CONDITION: has_rest_api^^
@@ -3589,7 +3589,7 @@ servers:
```graphql
# GraphQL Schema
{{graphql_schema}}
````
```
^^/CONDITION: has_graphql_api^^
@@ -5846,9 +5846,9 @@ Document the choice and key services that will be used.]]
Use appropriate diagram type for clarity.]]
````mermaid
```mermaid
{{architecture_diagram}}
```text
```
### Architectural Patterns
@@ -5959,7 +5959,7 @@ After presenting all data models, apply `tasks#advanced-elicitation` protocol]]
model_interface;
}
}
````
```
**Relationships:**
@@ -5983,7 +5983,7 @@ After presenting all data models, apply `tasks#advanced-elicitation` protocol]]
**TypeScript Interface:**
````typescript
```typescript
interface User {
id: string;
email: string;
@@ -6037,16 +6037,16 @@ servers:
'[object Object]': null
description:
'[object Object]': null
````
```
^^/CONDITION: has_rest_api^^
^^CONDITION: has_graphql_api^^
````graphql
```graphql
# GraphQL Schema
{{graphql_schema}}
```text
```
^^/CONDITION: has_graphql_api^^
@@ -6059,7 +6059,7 @@ servers:
trpc_routers;
}
}
````
```
^^/CONDITION: has_trpc_api^^
@@ -6204,19 +6204,19 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
**Component Organization:**
`````text
{{component_structure}}
```text
{{component_structure}}
```
**Component Template:**
````typescript
```typescript
{
{
component_template;
}
}
```text
```
### State Management Architecture
@@ -6230,7 +6230,7 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
state_structure;
}
}
`````
```
**State Management Patterns:**
@@ -6249,13 +6249,13 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
**Protected Route Pattern:**
````typescript
```typescript
{
{
protected_route_example;
}
}
```text
```
### Frontend Services Layer
@@ -6269,17 +6269,17 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
api_client_setup;
}
}
````
```
**Service Example:**
````typescript
```typescript
{
{
service_example;
}
}
```text
```
## Backend Architecture
@@ -6294,11 +6294,11 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
^^CONDITION: serverless^^
**Function Organization:**
````
```text
{{function_structure}}
````text
```
**Function Template:**
@@ -6308,26 +6308,26 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
function_template;
}
}
````
```
^^/CONDITION: serverless^^
^^CONDITION: traditional_server^^
**Controller/Route Organization:**
`````text
{{controller_structure}}
```text
{{controller_structure}}
```
**Controller Template:**
````typescript
```typescript
{
{
controller_template;
}
}
```text
```
^^/CONDITION: traditional_server^^
@@ -6339,17 +6339,17 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
```sql
{{database_schema}}
`````
```
**Data Access Layer:**
````typescript
```typescript
{
{
repository_pattern;
}
}
```text
```
### Authentication and Authorization
@@ -6359,17 +6359,17 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
```mermaid
{{auth_flow_diagram}}
````
```
**Middleware/Guards:**
````typescript
```typescript
{
{
auth_middleware;
}
}
```text
```
## Unified Project Structure
@@ -6429,7 +6429,7 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
├── package.json # Root package.json
├── {{monorepo_config}} # Monorepo configuration
└── README.md
````
```
@{example: vercel_structure}
apps/
@@ -6451,19 +6451,19 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
**Prerequisites:**
````bash
```bash
{{prerequisites_commands}}
```text
```
**Initial Setup:**
```bash
{{setup_commands}}
````
```
**Development Commands:**
````bash
```bash
# Start all services
{{start_all_command}}
@@ -6475,7 +6475,7 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
# Run tests
{{test_commands}}
```text
```
### Environment Configuration
@@ -6490,7 +6490,7 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
# Shared
{{shared_env_vars}}
````
```
## Deployment Architecture
@@ -6513,9 +6513,9 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
### CI/CD Pipeline
````yaml
```yaml
'[object Object]': null
```text
```
### Environments
@@ -6573,7 +6573,7 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
### Testing Pyramid
````
```text
E2E Tests
/ \
@@ -6582,17 +6582,17 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
/ \
Frontend Unit Backend Unit
```text
```
### Test Organization
**Frontend Tests:**
```
```text
{{frontend_test_structure}}
````text
```
**Backend Tests:**
@@ -6600,15 +6600,15 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
{{backend_test_structure}}
```text
```
**E2E Tests:**
````
```text
{{e2e_test_structure}}
````text
```
### Test Examples
@@ -6620,17 +6620,17 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
frontend_test_example;
}
}
````
```
**Backend API Test:**
````typescript
```typescript
{
{
backend_test_example;
}
}
```text
```
**E2E Test:**
@@ -6640,7 +6640,7 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
e2e_test_example;
}
}
````
```
## Coding Standards
@@ -6681,9 +6681,9 @@ After presenting this section, apply `tasks#advanced-elicitation` protocol]]
### Error Flow
````mermaid
```mermaid
{{error_flow_diagram}}
```text
```
### Error Response Format
@@ -6697,17 +6697,17 @@ interface ApiError {
requestId: string;
};
}
````
```
### Frontend Error Handling
````typescript
```typescript
{
{
frontend_error_handler;
}
}
```text
```
### Backend Error Handling
@@ -6717,7 +6717,7 @@ interface ApiError {
backend_error_handler;
}
}
````
```
## Monitoring and Observability
@@ -8268,8 +8268,7 @@ workflow:
- api-prototype
- simple-service
# For Complex Services (Production APIs, Multiple Endpoints)
complex_service_sequence:
sequence:
- agent: analyst
creates: project-brief.md
optional_steps:
@@ -8309,65 +8308,33 @@ workflow:
action: move_to_ide
notes: "All planning artifacts complete. Move to IDE environment to begin development. Explain to the user the IDE Development Workflow next steps: data#bmad-kb:IDE Development Workflow"
# For Simple Services (Simple APIs, Single Purpose Services)
simple_service_sequence:
- step: service_scope
action: assess complexity
notes: "First, assess if this needs full planning (use complex_service_sequence) or can be a simple API/service."
- agent: analyst
creates: project-brief.md
optional_steps:
- brainstorming_session
notes: "Creates focused project brief for simple service. SAVE OUTPUT: Copy final project-brief.md to your project's docs/ folder."
- agent: pm
creates: simple_epic OR single_story
uses: create-epic OR create-story
requires: project-brief.md
notes: "Create simple epic or story for API endpoints instead of full PRD for rapid development."
- workflow_end:
action: move_to_ide
notes: "Simple service defined. Move to IDE environment to begin development. Explain to the user the IDE Development Workflow next steps: data#bmad-kb:IDE Development Workflow"
flow_diagram: |
```mermaid
graph TD
A[Start: Service Development] --> B{Service Complexity?}
B -->|Complex/Production| C[analyst: project-brief.md]
B -->|Simple/Prototype| D[analyst: focused project-brief.md]
A[Start: Service Development] --> B[analyst: project-brief.md]
B --> C[pm: prd.md]
C --> D[architect: architecture.md]
D --> E{Architecture suggests PRD changes?}
E -->|Yes| F[pm: update prd.md]
E -->|No| G[po: validate all artifacts]
F --> G
G --> H{PO finds issues?}
H -->|Yes| I[Return to relevant agent for fixes]
H -->|No| J[Move to IDE Environment]
I --> G
C --> E[pm: prd.md]
E --> F[architect: architecture.md]
F --> G{Architecture suggests PRD changes?}
G -->|Yes| H[pm: update prd.md]
G -->|No| I[po: validate all artifacts]
H --> I
I --> J{PO finds issues?}
J -->|Yes| K[Return to relevant agent for fixes]
J -->|No| L[Move to IDE Environment]
K --> I
B -.-> B1[Optional: brainstorming]
B -.-> B2[Optional: market research]
D -.-> D1[Optional: technical research]
D --> M[pm: simple epic or story]
M --> N[Move to IDE Environment]
C -.-> C1[Optional: brainstorming]
C -.-> C2[Optional: market research]
F -.-> F1[Optional: technical research]
D -.-> D1[Optional: brainstorming]
style L fill:#90EE90
style N fill:#90EE90
style J fill:#90EE90
style B fill:#FFE4B5
style C fill:#FFE4B5
style E fill:#FFE4B5
style F fill:#FFE4B5
style D fill:#FFB6C1
style M fill:#FFB6C1
style D fill:#FFE4B5
```
decision_guidance:
use_complex_sequence_when:
when_to_use:
- Building production APIs or microservices
- Multiple endpoints and complex business logic
- Need comprehensive documentation and testing
@@ -8375,27 +8342,14 @@ workflow:
- Long-term maintenance expected
- Enterprise or external-facing APIs
use_simple_sequence_when:
- Building simple APIs or single-purpose services
- Few endpoints with straightforward logic
- Prototyping or proof-of-concept APIs
- Solo developer or small team
- Internal tools or utilities
- Learning or experimental projects
handoff_prompts:
# Complex sequence prompts
analyst_to_pm: "Project brief is complete. Save it as docs/project-brief.md in your project, then create the PRD."
pm_to_architect: "PRD is ready. Save it as docs/prd.md in your project, then create the service architecture."
architect_review: "Architecture complete. Save it as docs/architecture.md. Do you suggest any changes to the PRD stories or need new stories added?"
architect_to_pm: "Please update the PRD with the suggested story changes, then re-export the complete prd.md to docs/."
updated_to_po: "All documents ready in docs/ folder. Please validate all artifacts for consistency."
po_issues: "PO found issues with [document]. Please return to [agent] to fix and re-save the updated document."
complex_complete: "All planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
# Simple sequence prompts
simple_analyst_to_pm: "Focused project brief complete. Save it as docs/project-brief.md, then create simple epic or story for API development."
simple_complete: "Simple service defined. Move to IDE environment to begin development."
complete: "All planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
==================== END: workflows#greenfield-service ====================
==================== START: workflows#brownfield-service ====================
@@ -8413,16 +8367,11 @@ workflow:
- performance-optimization
- integration-enhancement
# For Complex Service Enhancements (Multiple Stories, Architectural Changes)
complex_enhancement_sequence:
- step: scope_assessment
agent: any
action: assess complexity
notes: "First, assess if this is a simple service change (use simple_enhancement_sequence) or complex enhancement requiring full planning."
sequence:
- step: service_analysis
agent: analyst
action: analyze existing service
agent: architect
action: analyze existing project and use task document-project
creates: multiple documents per the document-project template
notes: "Review existing service documentation, codebase, performance metrics, and identify integration dependencies."
- agent: pm
@@ -8451,69 +8400,35 @@ workflow:
action: move_to_ide
notes: "All planning artifacts complete. Move to IDE environment to begin development. Explain to the user the IDE Development Workflow next steps: data#bmad-kb:IDE Development Workflow"
# For Simple Service Enhancements (1-3 Stories, Following Existing Patterns)
simple_enhancement_sequence:
- step: enhancement_type
action: choose approach
notes: "Choose between creating single story (simple API endpoint) or epic (1-3 related service changes)."
- agent: pm|po|sm
creates: brownfield_epic OR brownfield_story
uses: brownfield-create-epic OR brownfield-create-story
notes: "Create focused service enhancement with existing API integration. Choose agent based on team preference and context."
- workflow_end:
action: move_to_ide
notes: "Service enhancement defined. Move to IDE environment to begin development. Explain to the user the IDE Development Workflow next steps: data#bmad-kb:IDE Development Workflow"
flow_diagram: |
```mermaid
graph TD
A[Start: Service Enhancement] --> B{Enhancement Complexity?}
B -->|Complex/Significant| C[analyst: analyze existing service]
B -->|Simple| D{1 Story or 2-3 Stories?}
A[Start: Service Enhancement] --> B[analyst: analyze existing service]
B --> C[pm: brownfield-prd.md]
C --> D[architect: brownfield-architecture.md]
D --> E[po: validate with po-master-checklist]
E --> F{PO finds issues?}
F -->|Yes| G[Return to relevant agent for fixes]
F -->|No| H[Move to IDE Environment]
G --> E
C --> E[pm: brownfield-prd.md]
E --> F[architect: brownfield-architecture.md]
F --> G[po: validate with po-master-checklist]
G --> H{PO finds issues?}
H -->|Yes| I[Return to relevant agent for fixes]
H -->|No| J[Move to IDE Environment]
I --> G
D -->|1 Story| K[pm/po/sm: brownfield-create-story]
D -->|2-3 Stories| L[pm/po/sm: brownfield-create-epic]
K --> M[Move to IDE Environment]
L --> M
style J fill:#90EE90
style M fill:#90EE90
style E fill:#FFE4B5
style F fill:#FFE4B5
style K fill:#FFB6C1
style L fill:#FFB6C1
style H fill:#90EE90
style C fill:#FFE4B5
style D fill:#FFE4B5
```
decision_guidance:
use_complex_sequence_when:
- Service enhancement requires multiple coordinated stories (4+)
when_to_use:
- Service enhancement requires coordinated stories
- API versioning or breaking changes needed
- Database schema changes required
- Performance or scalability improvements needed
- Multiple integration points affected
use_simple_sequence_when:
- Adding simple endpoints or modifying existing ones
- Enhancement follows existing service patterns
- API compatibility maintained
- Risk to existing service is low
- Change is isolated with clear boundaries
handoff_prompts:
analyst_to_pm: "Service analysis complete. Create comprehensive brownfield PRD with service integration strategy."
pm_to_architect: "Brownfield PRD ready. Save it as docs/brownfield-prd.md, then create the service architecture."
architect_to_po: "Architecture complete. Save it as docs/brownfield-architecture.md. Please validate all artifacts for service integration safety."
po_issues: "PO found issues with [document]. Please return to [agent] to fix and re-save the updated document."
simple_to_ide: "Service enhancement defined with existing API integration. Move to IDE environment to begin development."
complex_complete: "All brownfield planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
complete: "All brownfield planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
==================== END: workflows#brownfield-service ====================