Compare commits
2 Commits
main
...
feature/wo
| Author | SHA1 | Date |
|---|---|---|
mazemaze
|
617122195e | |
|
mazemaze
|
d533768f74 |
|
|
@ -0,0 +1,63 @@
|
|||
---
|
||||
description: View deployment logs from Eureka platform
|
||||
allowed-tools: Read, Bash, Glob
|
||||
---
|
||||
|
||||
# Eureka Deploy Logs
|
||||
|
||||
**Input**: "$ARGUMENTS"
|
||||
|
||||
---
|
||||
|
||||
## PURPOSE
|
||||
|
||||
View the deployment logs from the Eureka platform to debug issues or monitor progress.
|
||||
|
||||
---
|
||||
|
||||
## EXECUTION FLOW
|
||||
|
||||
### ═══════════════════════════════════════════════════════════════
|
||||
### PHASE 1: Fetch Logs
|
||||
### ═══════════════════════════════════════════════════════════════
|
||||
|
||||
#### 1.1: Run Logs Command
|
||||
|
||||
```bash
|
||||
# Default: last 100 lines
|
||||
eureka deploy logs
|
||||
|
||||
# Custom tail count
|
||||
eureka deploy logs --tail 200
|
||||
```
|
||||
|
||||
#### 1.2: Parse Arguments
|
||||
|
||||
If `$ARGUMENTS` contains a number, use it as tail count:
|
||||
```bash
|
||||
TAIL_COUNT="${ARGUMENTS:-100}"
|
||||
eureka deploy logs --tail "$TAIL_COUNT"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ARGUMENTS
|
||||
|
||||
| Argument | Default | Description |
|
||||
|----------|---------|-------------|
|
||||
| `[tail]` | `100` | Number of log lines to show |
|
||||
| `--id <deploymentId>` | Latest | Specific deployment ID |
|
||||
| `--follow` | `false` | Follow logs in real-time |
|
||||
|
||||
## EXAMPLES
|
||||
|
||||
```bash
|
||||
# View last 100 lines
|
||||
/eureka:deploy-logs
|
||||
|
||||
# View last 500 lines
|
||||
/eureka:deploy-logs 500
|
||||
|
||||
# View specific deployment
|
||||
/eureka:deploy-logs --id dep_abc123
|
||||
```
|
||||
|
|
@ -0,0 +1,55 @@
|
|||
---
|
||||
description: Check deployment status on Eureka platform
|
||||
allowed-tools: Read, Bash, Glob
|
||||
---
|
||||
|
||||
# Eureka Deploy Status
|
||||
|
||||
**Input**: "$ARGUMENTS"
|
||||
|
||||
---
|
||||
|
||||
## PURPOSE
|
||||
|
||||
Check the current deployment status of the application on the Eureka platform.
|
||||
|
||||
---
|
||||
|
||||
## EXECUTION FLOW
|
||||
|
||||
### ═══════════════════════════════════════════════════════════════
|
||||
### PHASE 1: Check Status
|
||||
### ═══════════════════════════════════════════════════════════════
|
||||
|
||||
#### 1.1: Run Status Command
|
||||
|
||||
```bash
|
||||
eureka deploy status --verbose
|
||||
```
|
||||
|
||||
#### 1.2: Display Results
|
||||
|
||||
The command will show:
|
||||
- Current deployment status (pending, building, deploying, deployed, failed)
|
||||
- Version information
|
||||
- Environment
|
||||
- Timestamps
|
||||
- Deployment URL (if deployed)
|
||||
|
||||
---
|
||||
|
||||
## ARGUMENTS
|
||||
|
||||
| Argument | Default | Description |
|
||||
|----------|---------|-------------|
|
||||
| `--verbose` | `false` | Show detailed logs |
|
||||
|
||||
## EXAMPLES
|
||||
|
||||
```bash
|
||||
# Check current deployment status
|
||||
/eureka:deploy-status
|
||||
|
||||
# Check with verbose output
|
||||
/eureka:deploy-status --verbose
|
||||
```
|
||||
|
|
@ -0,0 +1,279 @@
|
|||
---
|
||||
description: Deploy application to Eureka platform (creates app if needed)
|
||||
allowed-tools: Read, Write, Edit, Bash, Glob, Grep
|
||||
---
|
||||
|
||||
# Eureka Deploy
|
||||
|
||||
**Input**: "$ARGUMENTS"
|
||||
|
||||
---
|
||||
|
||||
## PURPOSE
|
||||
|
||||
Deploy the current project to the Eureka platform. If no `app_id` is configured, automatically creates a new directory app first, then triggers the deployment.
|
||||
|
||||
---
|
||||
|
||||
## ⛔ CRITICAL RULES
|
||||
|
||||
### MUST DO
|
||||
1. **MUST** check for existing `app_id` in `.claude/eureka-factory.yaml` first
|
||||
2. **MUST** create a new app via API if no `app_id` exists
|
||||
3. **MUST** save the new `app_id` to config after creation
|
||||
4. **MUST** display deployment status after triggering
|
||||
|
||||
### CANNOT DO
|
||||
1. **CANNOT** deploy without valid API key
|
||||
2. **CANNOT** skip app creation if `app_id` is missing
|
||||
3. **CANNOT** proceed if API calls fail
|
||||
|
||||
---
|
||||
|
||||
## EXECUTION FLOW
|
||||
|
||||
### ═══════════════════════════════════════════════════════════════
|
||||
### PHASE 1: Configuration Check
|
||||
### ═══════════════════════════════════════════════════════════════
|
||||
|
||||
#### 1.1: Display Start Banner
|
||||
|
||||
```
|
||||
╔══════════════════════════════════════════════════════════════╗
|
||||
║ 🚀 EUREKA DEPLOY ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ Deploying to Eureka Platform... ║
|
||||
╚══════════════════════════════════════════════════════════════╝
|
||||
```
|
||||
|
||||
#### 1.2: Check Configuration
|
||||
|
||||
Read the configuration file:
|
||||
```bash
|
||||
# Check if config exists
|
||||
cat .claude/eureka-factory.yaml 2>/dev/null || cat .claude/eureka-factory.yml 2>/dev/null || echo "NO_CONFIG"
|
||||
```
|
||||
|
||||
**Extract from config:**
|
||||
- `api_key` - Required for all operations
|
||||
- `app_id` - If exists, skip app creation
|
||||
- `api_endpoint` - Optional custom endpoint
|
||||
|
||||
#### 1.3: Validate API Key
|
||||
|
||||
If no `api_key` found:
|
||||
```
|
||||
╔══════════════════════════════════════════════════════════════╗
|
||||
║ ❌ NO API KEY CONFIGURED ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ Run `eureka setup` to configure your credentials. ║
|
||||
╚══════════════════════════════════════════════════════════════╝
|
||||
```
|
||||
**STOP EXECUTION**
|
||||
|
||||
---
|
||||
|
||||
### ═══════════════════════════════════════════════════════════════
|
||||
### PHASE 2: App Creation (if needed)
|
||||
### ═══════════════════════════════════════════════════════════════
|
||||
|
||||
#### 2.1: Check for app_id
|
||||
|
||||
If `app_id` exists in config → **SKIP TO PHASE 3**
|
||||
|
||||
If `app_id` is missing:
|
||||
|
||||
```
|
||||
╔══════════════════════════════════════════════════════════════╗
|
||||
║ 📁 CREATING DIRECTORY APP ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ No app_id found. Creating new app on Eureka... ║
|
||||
╚══════════════════════════════════════════════════════════════╝
|
||||
```
|
||||
|
||||
#### 2.2: Determine App Name
|
||||
|
||||
Use the project directory name as the default app name:
|
||||
```bash
|
||||
APP_NAME=$(basename $(pwd))
|
||||
echo "App name: $APP_NAME"
|
||||
```
|
||||
|
||||
Or use argument if provided: `$ARGUMENTS` as app name
|
||||
|
||||
#### 2.3: Create App via API
|
||||
|
||||
```bash
|
||||
# Create app using eureka CLI
|
||||
eureka deploy trigger --name "$APP_NAME" --type other --yes
|
||||
```
|
||||
|
||||
**If the command is not available, use direct API call:**
|
||||
|
||||
```bash
|
||||
API_KEY="<from config>"
|
||||
API_ENDPOINT="<from config or default>"
|
||||
|
||||
curl -X POST "${API_ENDPOINT}/v1/apps" \
|
||||
-H "Content-Type: application/json" \
|
||||
-H "X-API-Key: ${API_KEY}" \
|
||||
-d "{\"name\": \"${APP_NAME}\", \"type\": \"other\"}"
|
||||
```
|
||||
|
||||
#### 2.4: Save app_id to Config
|
||||
|
||||
Extract `app_id` from API response and update config:
|
||||
|
||||
```yaml
|
||||
# .claude/eureka-factory.yaml
|
||||
api_key: <existing>
|
||||
project_id: <existing>
|
||||
repo_id: <existing>
|
||||
app_id: <NEW_APP_ID> # Add this line
|
||||
```
|
||||
|
||||
```
|
||||
╔══════════════════════════════════════════════════════════════╗
|
||||
║ ✅ APP CREATED ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ App ID: <app_id> ║
|
||||
║ Saved to: .claude/eureka-factory.yaml ║
|
||||
╚══════════════════════════════════════════════════════════════╝
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### ═══════════════════════════════════════════════════════════════
|
||||
### PHASE 3: Trigger Deployment
|
||||
### ═══════════════════════════════════════════════════════════════
|
||||
|
||||
#### 3.1: Trigger Deploy
|
||||
|
||||
```bash
|
||||
# Using eureka CLI
|
||||
eureka deploy trigger --yes
|
||||
|
||||
# Or direct API call
|
||||
curl -X POST "${API_ENDPOINT}/v1/apps/${APP_ID}/deployments" \
|
||||
-H "Content-Type: application/json" \
|
||||
-H "X-API-Key: ${API_KEY}" \
|
||||
-d '{"environment": "production"}'
|
||||
```
|
||||
|
||||
#### 3.2: Display Deployment Status
|
||||
|
||||
```
|
||||
╔══════════════════════════════════════════════════════════════╗
|
||||
║ ✅ DEPLOYMENT TRIGGERED ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ Deployment ID: <deployment_id> ║
|
||||
║ Status: PENDING ║
|
||||
║ Environment: production ║
|
||||
║ Version: <version> ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ Use `/eureka:deploy-status` to check progress ║
|
||||
║ Use `/eureka:deploy-logs` to view logs ║
|
||||
╚══════════════════════════════════════════════════════════════╝
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ARGUMENTS
|
||||
|
||||
| Argument | Default | Description |
|
||||
|----------|---------|-------------|
|
||||
| `[app-name]` | Directory name | Name for new app (only used if creating) |
|
||||
| `--env <environment>` | `production` | Deployment environment |
|
||||
| `--branch <branch>` | Current branch | Git branch to deploy |
|
||||
| `--force` | `false` | Force deploy even if already deploying |
|
||||
|
||||
## EXAMPLES
|
||||
|
||||
```bash
|
||||
# Deploy current project (creates app if needed)
|
||||
/eureka:deploy
|
||||
|
||||
# Deploy with custom app name
|
||||
/eureka:deploy my-awesome-app
|
||||
|
||||
# Deploy specific branch to staging
|
||||
/eureka:deploy --env staging --branch develop
|
||||
|
||||
# Force redeploy
|
||||
/eureka:deploy --force
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ERROR HANDLING
|
||||
|
||||
### No Configuration
|
||||
```
|
||||
❌ No configuration found.
|
||||
Run `eureka setup` to configure credentials.
|
||||
```
|
||||
|
||||
### App Creation Failed
|
||||
```
|
||||
❌ Failed to create app: <error message>
|
||||
Check your API key and try again.
|
||||
```
|
||||
|
||||
### Deployment Failed
|
||||
```
|
||||
❌ Deployment failed: <error message>
|
||||
Use `/eureka:deploy-logs` to see details.
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## FLOW DIAGRAM
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────────┐
|
||||
│ /eureka:deploy │
|
||||
├─────────────────────────────────────────────────────────────────┤
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ ┌─────────────────┐ │
|
||||
│ │ Check Config │ │
|
||||
│ └────────┬────────┘ │
|
||||
│ │ │
|
||||
│ ┌─────────▼─────────┐ │
|
||||
│ │ Has API Key? │ │
|
||||
│ └─────────┬─────────┘ │
|
||||
│ │ │
|
||||
│ NO │ YES │
|
||||
│ ┌────────────────────┼────────────────────┐ │
|
||||
│ ▼ ▼ │
|
||||
│ ┌───────────┐ ┌─────────────────┐ │
|
||||
│ │ ERROR │ │ Has app_id? │ │
|
||||
│ │ No Key │ └────────┬────────┘ │
|
||||
│ └───────────┘ │ │
|
||||
│ NO │ YES │
|
||||
│ ┌───────────────────┼──────────┐ │
|
||||
│ ▼ ▼ │
|
||||
│ ┌─────────────────┐ ┌──────────────┐
|
||||
│ │ Create App │ │ │
|
||||
│ │ via API │ │ │
|
||||
│ └────────┬────────┘ │ │
|
||||
│ │ │ │
|
||||
│ ▼ │ │
|
||||
│ ┌─────────────────┐ │ │
|
||||
│ │ Save app_id │ │ │
|
||||
│ │ to Config │ │ │
|
||||
│ └────────┬────────┘ │ │
|
||||
│ │ │ │
|
||||
│ └───────────────────┘ │
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ ┌─────────────────┐ │
|
||||
│ │ Trigger Deploy │ │
|
||||
│ └────────┬────────┘ │
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ ┌─────────────────┐ │
|
||||
│ │ Show Status │ │
|
||||
│ └─────────────────┘ │
|
||||
└─────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
|
@ -0,0 +1,595 @@
|
|||
---
|
||||
description: Generate comprehensive project documentation for engineers and non-engineers
|
||||
allowed-tools: Read, Write, Edit, Bash, Task, TodoWrite, Glob, Grep
|
||||
---
|
||||
|
||||
# Eureka Index - Project Documentation Generator
|
||||
|
||||
**Input**: "$ARGUMENTS"
|
||||
|
||||
---
|
||||
|
||||
## PURPOSE
|
||||
|
||||
Generate comprehensive, dual-audience documentation by analyzing the current project structure using **parallel agent execution**. The output is designed to be understandable for **both engineers and non-engineers**.
|
||||
|
||||
### Documentation Layers
|
||||
|
||||
| Layer | Audience | Content |
|
||||
|-------|----------|---------|
|
||||
| Executive Summary | Everyone | Project purpose, value, capabilities |
|
||||
| Architecture Overview | Everyone | Visual diagrams, technology stack |
|
||||
| Getting Started | Semi-technical | Setup, basic usage, configuration |
|
||||
| Feature Guide | Non-engineers | Plain-language feature descriptions |
|
||||
| API Reference | Engineers | Endpoints, schemas, authentication |
|
||||
| Component Catalog | Engineers | Props, interfaces, usage examples |
|
||||
| Data Models | Both | ER diagrams + plain descriptions |
|
||||
| Glossary | Non-engineers | Technical terms explained |
|
||||
|
||||
---
|
||||
|
||||
## EXECUTION ARCHITECTURE
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────────────┐
|
||||
│ PARALLEL EXECUTION PIPELINE │
|
||||
├─────────────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ PHASE 1: PARALLEL ANALYSIS (run_in_background: true) │
|
||||
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌────────────┐ │
|
||||
│ │ Structure │ │ API │ │ Components │ │ Models │ │
|
||||
│ │ Analyzer │ │ Analyzer │ │ Analyzer │ │ Analyzer │ │
|
||||
│ └──────┬───────┘ └──────┬───────┘ └──────┬───────┘ └─────┬──────┘ │
|
||||
│ │ │ │ │ │
|
||||
│ ▼ ▼ ▼ ▼ │
|
||||
│ PHASE 2: SYNCHRONIZATION │
|
||||
│ ┌─────────────────────────────────────────────────────────────┐ │
|
||||
│ │ Merge & Create Unified Analysis │ │
|
||||
│ └─────────────────────────────────────────────────────────────┘ │
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ PHASE 3: PARALLEL DOCUMENTATION (run_in_background: true) │
|
||||
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌────────────┐ │
|
||||
│ │ Main Doc │ │ API Docs │ │ Components │ │ Quick │ │
|
||||
│ │ Generator │ │ Generator │ │ Generator │ │ Reference │ │
|
||||
│ └──────┬───────┘ └──────┬───────┘ └──────┬───────┘ └─────┬──────┘ │
|
||||
│ │ │ │ │ │
|
||||
│ ▼ ▼ ▼ ▼ │
|
||||
│ PHASE 4: FINALIZATION │
|
||||
│ ┌─────────────────────────────────────────────────────────────┐ │
|
||||
│ │ HTML Generation + Validation + Summary │ │
|
||||
│ └─────────────────────────────────────────────────────────────┘ │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ⛔ CRITICAL RULES
|
||||
|
||||
### MUST DO
|
||||
1. **MUST** launch analysis agents in parallel using `run_in_background: true`
|
||||
2. **MUST** wait for all analysis agents before synchronization
|
||||
3. **MUST** launch documentation agents in parallel after synchronization
|
||||
4. **MUST** include both technical and non-technical descriptions
|
||||
5. **MUST** validate generated documentation against actual code
|
||||
|
||||
### CANNOT DO
|
||||
1. **CANNOT** make up features that don't exist
|
||||
2. **CANNOT** skip the parallel analysis phase
|
||||
3. **CANNOT** generate docs without synchronizing analysis results
|
||||
|
||||
---
|
||||
|
||||
## EXECUTION FLOW
|
||||
|
||||
### ═══════════════════════════════════════════════════════════════
|
||||
### PHASE 1: Parallel Analysis
|
||||
### ═══════════════════════════════════════════════════════════════
|
||||
|
||||
#### 1.1: Display Start Banner & Setup
|
||||
```
|
||||
╔══════════════════════════════════════════════════════════════╗
|
||||
║ 📚 EUREKA INDEX - Parallel Documentation Generator ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ Launching parallel analysis agents... ║
|
||||
║ Output: Dual-audience documentation (Engineer + Non-Engineer)║
|
||||
╚══════════════════════════════════════════════════════════════╝
|
||||
```
|
||||
|
||||
```bash
|
||||
OUTPUT_DIR="${ARGUMENTS:-docs}"
|
||||
mkdir -p "$OUTPUT_DIR"
|
||||
echo "📁 Output directory: $OUTPUT_DIR"
|
||||
```
|
||||
|
||||
#### 1.2: Launch Parallel Analysis Agents
|
||||
|
||||
**CRITICAL: Launch ALL four agents in a SINGLE message with multiple Task tool calls:**
|
||||
|
||||
```
|
||||
Launch these 4 Task agents IN PARALLEL (single message, multiple tool calls):
|
||||
|
||||
┌─────────────────────────────────────────────────────────────────┐
|
||||
│ AGENT 1: Structure Analyzer │
|
||||
├─────────────────────────────────────────────────────────────────┤
|
||||
│ Task tool with: │
|
||||
│ subagent_type: "Explore" │
|
||||
│ run_in_background: true │
|
||||
│ prompt: | │
|
||||
│ # PROJECT STRUCTURE ANALYSIS │
|
||||
│ │
|
||||
│ Analyze the project structure and return findings. │
|
||||
│ │
|
||||
│ ## Tasks │
|
||||
│ 1. Identify project type (package.json, requirements.txt, │
|
||||
│ Cargo.toml, go.mod, pom.xml) │
|
||||
│ 2. Extract metadata (name, version, description) │
|
||||
│ 3. Map directory structure with purposes │
|
||||
│ 4. Identify tech stack (language, framework, database) │
|
||||
│ 5. List key dependencies with plain English purposes │
|
||||
│ │
|
||||
│ ## Output Format (YAML) │
|
||||
│ ```yaml │
|
||||
│ project: │
|
||||
│ name: "..." │
|
||||
│ version: "..." │
|
||||
│ description: "..." │
|
||||
│ type: "node|python|rust|go|java|other" │
|
||||
│ tech_stack: │
|
||||
│ language: "..." │
|
||||
│ framework: "..." │
|
||||
│ database: "..." │
|
||||
│ structure: │
|
||||
│ directories: │
|
||||
│ - path: "..." │
|
||||
│ purpose: "..." │
|
||||
│ file_count: N │
|
||||
│ dependencies: │
|
||||
│ - name: "..." │
|
||||
│ purpose: "plain English" │
|
||||
│ ``` │
|
||||
└─────────────────────────────────────────────────────────────────┘
|
||||
|
||||
┌─────────────────────────────────────────────────────────────────┐
|
||||
│ AGENT 2: API Analyzer │
|
||||
├─────────────────────────────────────────────────────────────────┤
|
||||
│ Task tool with: │
|
||||
│ subagent_type: "Explore" │
|
||||
│ run_in_background: true │
|
||||
│ prompt: | │
|
||||
│ # API ENDPOINTS ANALYSIS │
|
||||
│ │
|
||||
│ Find and analyze all API endpoints in the project. │
|
||||
│ │
|
||||
│ ## Search Patterns │
|
||||
│ - Next.js App Router: app/api/**/route.ts │
|
||||
│ - Next.js Pages: pages/api/**/*.ts │
|
||||
│ - Express: router.get/post/put/delete │
|
||||
│ - FastAPI: @app.get/post/put/delete │
|
||||
│ - GraphQL: Query/Mutation resolvers │
|
||||
│ │
|
||||
│ ## Output Format (YAML) │
|
||||
│ ```yaml │
|
||||
│ api_endpoints: │
|
||||
│ - method: "GET|POST|PUT|DELETE" │
|
||||
│ path: "/api/..." │
|
||||
│ handler_file: "path/to/file.ts" │
|
||||
│ description: "plain English" │
|
||||
│ request_body: "schema if POST/PUT" │
|
||||
│ response: "schema summary" │
|
||||
│ auth_required: true|false │
|
||||
│ ``` │
|
||||
│ │
|
||||
│ If no APIs found, return: api_endpoints: [] │
|
||||
└─────────────────────────────────────────────────────────────────┘
|
||||
|
||||
┌─────────────────────────────────────────────────────────────────┐
|
||||
│ AGENT 3: Components Analyzer │
|
||||
├─────────────────────────────────────────────────────────────────┤
|
||||
│ Task tool with: │
|
||||
│ subagent_type: "Explore" │
|
||||
│ run_in_background: true │
|
||||
│ prompt: | │
|
||||
│ # UI COMPONENTS ANALYSIS │
|
||||
│ │
|
||||
│ Find and analyze all UI components in the project. │
|
||||
│ │
|
||||
│ ## Search Patterns │
|
||||
│ - React: components/**/*.tsx, function Component() │
|
||||
│ - Vue: components/**/*.vue, <script setup> │
|
||||
│ - Angular: *.component.ts, @Component │
|
||||
│ - Svelte: **/*.svelte │
|
||||
│ │
|
||||
│ ## Output Format (YAML) │
|
||||
│ ```yaml │
|
||||
│ components: │
|
||||
│ - id: "component_name" │
|
||||
│ name: "ComponentName" │
|
||||
│ path: "path/to/Component.tsx" │
|
||||
│ description: "what it does in plain English" │
|
||||
│ props: │
|
||||
│ - name: "propName" │
|
||||
│ type: "string|number|boolean|..." │
|
||||
│ required: true|false │
|
||||
│ description: "what it controls" │
|
||||
│ events: ["onClick", "onChange"] │
|
||||
│ dependencies: ["OtherComponent"] │
|
||||
│ ``` │
|
||||
│ │
|
||||
│ If no components found, return: components: [] │
|
||||
└─────────────────────────────────────────────────────────────────┘
|
||||
|
||||
┌─────────────────────────────────────────────────────────────────┐
|
||||
│ AGENT 4: Data Models Analyzer │
|
||||
├─────────────────────────────────────────────────────────────────┤
|
||||
│ Task tool with: │
|
||||
│ subagent_type: "Explore" │
|
||||
│ run_in_background: true │
|
||||
│ prompt: | │
|
||||
│ # DATA MODELS ANALYSIS │
|
||||
│ │
|
||||
│ Find and analyze all data models in the project. │
|
||||
│ │
|
||||
│ ## Search Patterns │
|
||||
│ - Prisma: prisma/schema.prisma, model X {} │
|
||||
│ - TypeORM: @Entity(), entities/**/*.ts │
|
||||
│ - Mongoose: new Schema(), models/**/*.ts │
|
||||
│ - SQLAlchemy: class X(Base), models/**/*.py │
|
||||
│ - TypeScript: interface/type definitions │
|
||||
│ │
|
||||
│ ## Output Format (YAML) │
|
||||
│ ```yaml │
|
||||
│ data_models: │
|
||||
│ - name: "ModelName" │
|
||||
│ source: "prisma|typeorm|mongoose|typescript" │
|
||||
│ file_path: "path/to/model" │
|
||||
│ description: "what data it represents" │
|
||||
│ fields: │
|
||||
│ - name: "fieldName" │
|
||||
│ type: "String|Int|Boolean|..." │
|
||||
│ description: "plain English" │
|
||||
│ constraints: "unique|optional|default" │
|
||||
│ relations: │
|
||||
│ - type: "hasMany|belongsTo|hasOne" │
|
||||
│ target: "OtherModel" │
|
||||
│ glossary_terms: │
|
||||
│ - term: "technical term found" │
|
||||
│ definition: "plain English definition" │
|
||||
│ ``` │
|
||||
│ │
|
||||
│ If no models found, return: data_models: [] │
|
||||
└─────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
#### 1.3: Wait for All Analysis Agents
|
||||
|
||||
```
|
||||
Use TaskOutput tool to wait for each agent:
|
||||
- TaskOutput with task_id from Agent 1, block: true
|
||||
- TaskOutput with task_id from Agent 2, block: true
|
||||
- TaskOutput with task_id from Agent 3, block: true
|
||||
- TaskOutput with task_id from Agent 4, block: true
|
||||
|
||||
Collect all results for synchronization.
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### ═══════════════════════════════════════════════════════════════
|
||||
### PHASE 2: Synchronization
|
||||
### ═══════════════════════════════════════════════════════════════
|
||||
|
||||
#### 2.1: Merge Analysis Results
|
||||
|
||||
Combine outputs from all 4 agents into a unified analysis:
|
||||
|
||||
```yaml
|
||||
# $OUTPUT_DIR/analysis.yml - Merged from parallel agents
|
||||
|
||||
project:
|
||||
# From Agent 1: Structure Analyzer
|
||||
name: "..."
|
||||
version: "..."
|
||||
description: "..."
|
||||
type: "..."
|
||||
|
||||
tech_stack:
|
||||
# From Agent 1: Structure Analyzer
|
||||
language: "..."
|
||||
framework: "..."
|
||||
database: "..."
|
||||
key_dependencies: [...]
|
||||
|
||||
structure:
|
||||
# From Agent 1: Structure Analyzer
|
||||
directories: [...]
|
||||
|
||||
api_endpoints:
|
||||
# From Agent 2: API Analyzer
|
||||
[...]
|
||||
|
||||
components:
|
||||
# From Agent 3: Components Analyzer
|
||||
[...]
|
||||
|
||||
data_models:
|
||||
# From Agent 4: Data Models Analyzer
|
||||
[...]
|
||||
|
||||
glossary_terms:
|
||||
# Merged from all agents
|
||||
[...]
|
||||
```
|
||||
|
||||
#### 2.2: Write Unified Analysis File
|
||||
|
||||
```bash
|
||||
# Write merged analysis to file
|
||||
Write the unified YAML to: $OUTPUT_DIR/analysis.yml
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### ═══════════════════════════════════════════════════════════════
|
||||
### PHASE 3: Parallel Documentation Generation
|
||||
### ═══════════════════════════════════════════════════════════════
|
||||
|
||||
#### 3.1: Launch Parallel Documentation Agents
|
||||
|
||||
**CRITICAL: Launch ALL four doc agents in a SINGLE message with multiple Task tool calls:**
|
||||
|
||||
```
|
||||
Launch these 4 Task agents IN PARALLEL (single message, multiple tool calls):
|
||||
|
||||
┌─────────────────────────────────────────────────────────────────┐
|
||||
│ DOC AGENT 1: Main Documentation │
|
||||
├─────────────────────────────────────────────────────────────────┤
|
||||
│ Task tool with: │
|
||||
│ subagent_type: "technical-writer" │
|
||||
│ run_in_background: true │
|
||||
│ prompt: | │
|
||||
│ # Generate PROJECT_DOCUMENTATION.md │
|
||||
│ │
|
||||
│ Using the analysis from $OUTPUT_DIR/analysis.yml, │
|
||||
│ generate comprehensive main documentation. │
|
||||
│ │
|
||||
│ ## Sections Required │
|
||||
│ 1. Executive Summary (plain English, no jargon) │
|
||||
│ 2. Quick Start (installation, basic usage) │
|
||||
│ 3. Architecture Overview (ASCII diagrams) │
|
||||
│ 4. Features (dual-audience: plain + technical details) │
|
||||
│ 5. Glossary (all technical terms explained) │
|
||||
│ │
|
||||
│ ## Rules │
|
||||
│ - Plain English FIRST, technical in <details> tags │
|
||||
│ - Include ASCII architecture diagrams │
|
||||
│ - Use tables for structured data │
|
||||
│ - Code blocks with language hints │
|
||||
│ │
|
||||
│ Write to: $OUTPUT_DIR/PROJECT_DOCUMENTATION.md │
|
||||
└─────────────────────────────────────────────────────────────────┘
|
||||
|
||||
┌─────────────────────────────────────────────────────────────────┐
|
||||
│ DOC AGENT 2: API Reference │
|
||||
├─────────────────────────────────────────────────────────────────┤
|
||||
│ Task tool with: │
|
||||
│ subagent_type: "technical-writer" │
|
||||
│ run_in_background: true │
|
||||
│ prompt: | │
|
||||
│ # Generate API_REFERENCE.md │
|
||||
│ │
|
||||
│ Using api_endpoints from $OUTPUT_DIR/analysis.yml, │
|
||||
│ generate detailed API documentation. │
|
||||
│ │
|
||||
│ ## Format per Endpoint │
|
||||
│ ### [METHOD] /path │
|
||||
│ **Description**: Plain English │
|
||||
│ **Authentication**: Required/Optional │
|
||||
│ │
|
||||
│ <details> │
|
||||
│ <summary>Technical Details</summary> │
|
||||
│ Request body, response schema, example │
|
||||
│ </details> │
|
||||
│ │
|
||||
│ If no APIs exist, write brief note explaining this. │
|
||||
│ │
|
||||
│ Write to: $OUTPUT_DIR/API_REFERENCE.md │
|
||||
└─────────────────────────────────────────────────────────────────┘
|
||||
|
||||
┌─────────────────────────────────────────────────────────────────┐
|
||||
│ DOC AGENT 3: Components Catalog │
|
||||
├─────────────────────────────────────────────────────────────────┤
|
||||
│ Task tool with: │
|
||||
│ subagent_type: "technical-writer" │
|
||||
│ run_in_background: true │
|
||||
│ prompt: | │
|
||||
│ # Generate COMPONENTS.md │
|
||||
│ │
|
||||
│ Using components from $OUTPUT_DIR/analysis.yml, │
|
||||
│ generate component catalog documentation. │
|
||||
│ │
|
||||
│ ## Format per Component │
|
||||
│ ### ComponentName │
|
||||
│ **Purpose**: Plain English description │
|
||||
│ **Location**: `path/to/file` │
|
||||
│ │
|
||||
│ <details> │
|
||||
│ <summary>Props & Usage</summary> │
|
||||
│ Props table, usage example, dependencies │
|
||||
│ </details> │
|
||||
│ │
|
||||
│ If no components exist, write brief note explaining this. │
|
||||
│ │
|
||||
│ Write to: $OUTPUT_DIR/COMPONENTS.md │
|
||||
└─────────────────────────────────────────────────────────────────┘
|
||||
|
||||
┌─────────────────────────────────────────────────────────────────┐
|
||||
│ DOC AGENT 4: Quick Reference │
|
||||
├─────────────────────────────────────────────────────────────────┤
|
||||
│ Task tool with: │
|
||||
│ subagent_type: "technical-writer" │
|
||||
│ run_in_background: true │
|
||||
│ prompt: | │
|
||||
│ # Generate QUICK_REFERENCE.md │
|
||||
│ │
|
||||
│ Using $OUTPUT_DIR/analysis.yml, create a one-page │
|
||||
│ quick reference card. │
|
||||
│ │
|
||||
│ ## Sections (tables only, minimal text) │
|
||||
│ - Commands (npm scripts, make targets) │
|
||||
│ - Key Files (important files and purposes) │
|
||||
│ - API Endpoints (method, path, purpose) │
|
||||
│ - Environment Variables │
|
||||
│ - Common Patterns │
|
||||
│ │
|
||||
│ Keep it to ONE PAGE - scannable, dense, useful. │
|
||||
│ │
|
||||
│ Write to: $OUTPUT_DIR/QUICK_REFERENCE.md │
|
||||
└─────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
#### 3.2: Wait for All Documentation Agents
|
||||
|
||||
```
|
||||
Use TaskOutput tool to wait for each doc agent:
|
||||
- TaskOutput with task_id from Doc Agent 1, block: true
|
||||
- TaskOutput with task_id from Doc Agent 2, block: true
|
||||
- TaskOutput with task_id from Doc Agent 3, block: true
|
||||
- TaskOutput with task_id from Doc Agent 4, block: true
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### ═══════════════════════════════════════════════════════════════
|
||||
### PHASE 4: Finalization
|
||||
### ═══════════════════════════════════════════════════════════════
|
||||
|
||||
#### 4.1: Generate HTML Documentation (Optional)
|
||||
|
||||
```bash
|
||||
# If Python scripts exist, generate HTML
|
||||
if [ -f "skills/documentation-generator/scripts/generate_html.py" ]; then
|
||||
python3 skills/documentation-generator/scripts/generate_html.py \
|
||||
$OUTPUT_DIR/analysis.yml \
|
||||
skills/documentation-generator/templates/documentation.html \
|
||||
$OUTPUT_DIR/index.html
|
||||
fi
|
||||
```
|
||||
|
||||
#### 4.2: Validate Generated Documentation
|
||||
|
||||
Verify all documentation files exist and are non-empty:
|
||||
- `$OUTPUT_DIR/analysis.yml`
|
||||
- `$OUTPUT_DIR/PROJECT_DOCUMENTATION.md`
|
||||
- `$OUTPUT_DIR/API_REFERENCE.md`
|
||||
- `$OUTPUT_DIR/COMPONENTS.md`
|
||||
- `$OUTPUT_DIR/QUICK_REFERENCE.md`
|
||||
|
||||
#### 4.3: Display Completion Banner
|
||||
|
||||
```
|
||||
╔══════════════════════════════════════════════════════════════╗
|
||||
║ ✅ PARALLEL DOCUMENTATION COMPLETE ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ Execution: 4 analysis agents → sync → 4 doc agents ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ Output Directory: $OUTPUT_DIR ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ Files Created: ║
|
||||
║ 📊 analysis.yml (Merged analysis data) ║
|
||||
║ 📄 PROJECT_DOCUMENTATION.md (Main documentation) ║
|
||||
║ 📄 API_REFERENCE.md (API details) ║
|
||||
║ 📄 COMPONENTS.md (Component catalog) ║
|
||||
║ 📄 QUICK_REFERENCE.md (One-page reference) ║
|
||||
║ 🌐 index.html (HTML version - if generated) ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ Performance: ║
|
||||
║ ⚡ Analysis: 4 agents in parallel ║
|
||||
║ ⚡ Documentation: 4 agents in parallel ║
|
||||
║ ⚡ Total: ~2x faster than sequential execution ║
|
||||
╚══════════════════════════════════════════════════════════════╝
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ARGUMENTS
|
||||
|
||||
| Argument | Default | Description |
|
||||
|----------|---------|-------------|
|
||||
| `[output_dir]` | `docs` | Output directory for documentation |
|
||||
| `--format` | `markdown` | Output format: markdown, html |
|
||||
| `--sections` | `all` | Sections to include: all, api, components, models |
|
||||
| `--audience` | `both` | Target: both, technical, non-technical |
|
||||
|
||||
## EXAMPLES
|
||||
|
||||
```bash
|
||||
# Generate full documentation with parallel agents
|
||||
/eureka:index
|
||||
|
||||
# Generate in custom directory
|
||||
/eureka:index my-docs
|
||||
|
||||
# Generate API-only documentation
|
||||
/eureka:index --sections api
|
||||
|
||||
# Generate non-technical documentation only
|
||||
/eureka:index --audience non-technical
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## PARALLEL EXECUTION BENEFITS
|
||||
|
||||
| Metric | Sequential | Parallel | Improvement |
|
||||
|--------|-----------|----------|-------------|
|
||||
| Analysis Phase | 4x agent time | 1x agent time | 75% faster |
|
||||
| Doc Generation | 4x agent time | 1x agent time | 75% faster |
|
||||
| Total Time | ~8 units | ~2 units | **4x faster** |
|
||||
|
||||
---
|
||||
|
||||
## DUAL-AUDIENCE WRITING GUIDELINES
|
||||
|
||||
### For Non-Engineers (Primary)
|
||||
- Lead with "What" and "Why", not "How"
|
||||
- Use analogies and real-world comparisons
|
||||
- Avoid acronyms; spell them out first time
|
||||
- Use bullet points over paragraphs
|
||||
- Include visual diagrams
|
||||
|
||||
### For Engineers (Secondary)
|
||||
- Include in collapsible `<details>` sections
|
||||
- Provide code examples
|
||||
- Reference file paths and line numbers
|
||||
- Include type definitions
|
||||
- Link to source files
|
||||
|
||||
### Balance Example
|
||||
|
||||
```markdown
|
||||
## User Authentication
|
||||
|
||||
**What it does**: Allows users to securely log into the application
|
||||
using their email and password.
|
||||
|
||||
**How it works** (simplified):
|
||||
1. User enters credentials
|
||||
2. System verifies them
|
||||
3. User receives access
|
||||
|
||||
<details>
|
||||
<summary>Technical Implementation</summary>
|
||||
|
||||
- **Strategy**: JWT-based authentication
|
||||
- **Token Storage**: HTTP-only cookies
|
||||
- **Session Duration**: 24 hours
|
||||
- **Refresh Logic**: Automatic refresh 1 hour before expiry
|
||||
|
||||
**Key Files**:
|
||||
- `src/auth/jwt.service.ts` - Token generation
|
||||
- `src/auth/auth.guard.ts` - Route protection
|
||||
|
||||
</details>
|
||||
```
|
||||
|
|
@ -0,0 +1,660 @@
|
|||
---
|
||||
description: Generate a designer-quality landing page from project documentation with AI-generated images
|
||||
allowed-tools: Read, Write, Edit, Bash, Task, TodoWrite, Glob, Grep, mcp__eureka-imagen__generate_hero_image, mcp__eureka-imagen__generate_feature_icon, mcp__eureka-imagen__generate_illustration, mcp__eureka-imagen__generate_og_image, mcp__eureka-imagen__generate_logo_concept, mcp__eureka-imagen__list_available_models, mcp__eureka-imagen__check_status
|
||||
---
|
||||
|
||||
# Eureka Landing - Landing Page Generator
|
||||
|
||||
**Input**: "$ARGUMENTS"
|
||||
|
||||
---
|
||||
|
||||
## PURPOSE
|
||||
|
||||
Generate a **designer-quality landing page** with concept branding and Q&A section based on existing project documentation. This command requires documentation to be generated first via `/eureka:index`.
|
||||
|
||||
### Output Features
|
||||
|
||||
| Feature | Description |
|
||||
|---------|-------------|
|
||||
| Hero Section | Compelling headline, tagline, CTA buttons |
|
||||
| Features Grid | Visual feature cards with icons |
|
||||
| How It Works | Step-by-step visual flow |
|
||||
| Screenshots/Demo | Placeholder for app visuals |
|
||||
| Q&A/FAQ | Common questions answered |
|
||||
| Concept Branding | Colors, typography, visual style |
|
||||
| Responsive Design | Mobile-first, works on all devices |
|
||||
| Dark Mode | Automatic system preference detection |
|
||||
| **AI Images** | AI-generated hero, icons, illustrations (ImageRouter) |
|
||||
|
||||
### Image Generation (Optional)
|
||||
|
||||
When `--with-images` flag is used and IMAGEROUTER_API_KEY is set, the command will:
|
||||
- Generate a hero banner image
|
||||
- Generate feature icons
|
||||
- Generate how-it-works illustrations
|
||||
- Generate OG image for social sharing
|
||||
|
||||
```bash
|
||||
# With AI-generated images
|
||||
/eureka:landing --with-images
|
||||
|
||||
# Without images (default)
|
||||
/eureka:landing
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## PREREQUISITES
|
||||
|
||||
```
|
||||
╔══════════════════════════════════════════════════════════════╗
|
||||
║ ⚠️ REQUIRES DOCUMENTATION FIRST ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ ║
|
||||
║ This command uses data from /eureka:index output. ║
|
||||
║ ║
|
||||
║ Required files: ║
|
||||
║ ✓ docs/analysis.yml (or custom output dir) ║
|
||||
║ ✓ docs/PROJECT_DOCUMENTATION.md ║
|
||||
║ ║
|
||||
║ If missing, run first: ║
|
||||
║ /eureka:index ║
|
||||
║ ║
|
||||
╚══════════════════════════════════════════════════════════════╝
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## EXECUTION FLOW
|
||||
|
||||
### ═══════════════════════════════════════════════════════════════
|
||||
### PHASE 1: Validate Prerequisites
|
||||
### ═══════════════════════════════════════════════════════════════
|
||||
|
||||
#### 1.1: Check for Documentation
|
||||
|
||||
```bash
|
||||
DOCS_DIR="${ARGUMENTS:-docs}"
|
||||
|
||||
# Check if documentation exists
|
||||
if [ ! -f "$DOCS_DIR/analysis.yml" ] && [ ! -f "$DOCS_DIR/PROJECT_DOCUMENTATION.md" ]; then
|
||||
echo "❌ ERROR: Documentation not found!"
|
||||
echo ""
|
||||
echo "Required: $DOCS_DIR/analysis.yml or $DOCS_DIR/PROJECT_DOCUMENTATION.md"
|
||||
echo ""
|
||||
echo "Run first: /eureka:index"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
echo "✅ Documentation found in $DOCS_DIR"
|
||||
```
|
||||
|
||||
#### 1.2: Display Start Banner
|
||||
|
||||
```
|
||||
╔══════════════════════════════════════════════════════════════╗
|
||||
║ 🎨 EUREKA LANDING - Designer Landing Page Generator ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ Creating: Hero + Features + How It Works + Q&A ║
|
||||
║ Style: Modern, professional, conversion-optimized ║
|
||||
╚══════════════════════════════════════════════════════════════╝
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### ═══════════════════════════════════════════════════════════════
|
||||
### PHASE 2: Parallel Content Generation
|
||||
### ═══════════════════════════════════════════════════════════════
|
||||
|
||||
#### 2.1: Launch Content Generation Agents in Parallel
|
||||
|
||||
**CRITICAL: Launch ALL agents in a SINGLE message:**
|
||||
|
||||
```
|
||||
Launch these 4 Task agents IN PARALLEL:
|
||||
|
||||
┌─────────────────────────────────────────────────────────────────┐
|
||||
│ AGENT 1: Branding Concept Generator │
|
||||
├─────────────────────────────────────────────────────────────────┤
|
||||
│ Task tool with: │
|
||||
│ subagent_type: "frontend-architect" │
|
||||
│ run_in_background: true │
|
||||
│ prompt: | │
|
||||
│ # CONCEPT BRANDING GENERATION │
|
||||
│ │
|
||||
│ Read $DOCS_DIR/analysis.yml and create a branding concept. │
|
||||
│ │
|
||||
│ ## Output: branding.json │
|
||||
│ ```json │
|
||||
│ { │
|
||||
│ "brand": { │
|
||||
│ "name": "Project Name", │
|
||||
│ "tagline": "Compelling one-liner", │
|
||||
│ "value_proposition": "What makes it special" │
|
||||
│ }, │
|
||||
│ "colors": { │
|
||||
│ "primary": "#hex - main brand color", │
|
||||
│ "secondary": "#hex - accent color", │
|
||||
│ "accent": "#hex - CTA/highlight color", │
|
||||
│ "background": "#hex - light bg", │
|
||||
│ "background_dark": "#hex - dark mode bg", │
|
||||
│ "text": "#hex - primary text", │
|
||||
│ "text_muted": "#hex - secondary text" │
|
||||
│ }, │
|
||||
│ "typography": { │
|
||||
│ "heading_font": "Inter, system-ui, sans-serif", │
|
||||
│ "body_font": "Inter, system-ui, sans-serif", │
|
||||
│ "mono_font": "JetBrains Mono, monospace" │
|
||||
│ }, │
|
||||
│ "style": { │
|
||||
│ "border_radius": "12px", │
|
||||
│ "shadow": "0 4px 6px -1px rgba(0,0,0,0.1)", │
|
||||
│ "gradient": "linear-gradient(...)" │
|
||||
│ }, │
|
||||
│ "icons": { │
|
||||
│ "style": "lucide|heroicons|phosphor", │
|
||||
│ "feature_icons": ["icon1", "icon2", ...] │
|
||||
│ } │
|
||||
│ } │
|
||||
│ ``` │
|
||||
│ │
|
||||
│ Base colors on project type: │
|
||||
│ - Developer tools: Blues, purples │
|
||||
│ - Business apps: Blues, greens │
|
||||
│ - Creative tools: Vibrant, gradients │
|
||||
│ - Data/Analytics: Teals, blues │
|
||||
│ │
|
||||
│ Write to: $DOCS_DIR/branding.json │
|
||||
└─────────────────────────────────────────────────────────────────┘
|
||||
|
||||
┌─────────────────────────────────────────────────────────────────┐
|
||||
│ AGENT 2: Hero & Features Content │
|
||||
├─────────────────────────────────────────────────────────────────┤
|
||||
│ Task tool with: │
|
||||
│ subagent_type: "technical-writer" │
|
||||
│ run_in_background: true │
|
||||
│ prompt: | │
|
||||
│ # HERO & FEATURES CONTENT │
|
||||
│ │
|
||||
│ Read $DOCS_DIR/analysis.yml and create marketing content. │
|
||||
│ │
|
||||
│ ## Output: content.json │
|
||||
│ ```json │
|
||||
│ { │
|
||||
│ "hero": { │
|
||||
│ "headline": "Powerful, benefit-focused headline", │
|
||||
│ "subheadline": "Explain the value in one sentence", │
|
||||
│ "cta_primary": "Get Started", │
|
||||
│ "cta_secondary": "Learn More", │
|
||||
│ "social_proof": "Used by X developers" │
|
||||
│ }, │
|
||||
│ "features": [ │
|
||||
│ { │
|
||||
│ "title": "Feature Name", │
|
||||
│ "description": "Benefit-focused description", │
|
||||
│ "icon": "suggested-icon-name" │
|
||||
│ } │
|
||||
│ ], │
|
||||
│ "how_it_works": [ │
|
||||
│ { │
|
||||
│ "step": 1, │
|
||||
│ "title": "Step Title", │
|
||||
│ "description": "What happens" │
|
||||
│ } │
|
||||
│ ], │
|
||||
│ "stats": [ │
|
||||
│ { "value": "10x", "label": "Faster" } │
|
||||
│ ] │
|
||||
│ } │
|
||||
│ ``` │
|
||||
│ │
|
||||
│ Writing Rules: │
|
||||
│ - Headlines: Benefit-focused, action-oriented │
|
||||
│ - Features: Max 6, each with clear benefit │
|
||||
│ - How It Works: 3-4 steps maximum │
|
||||
│ - Use numbers and specifics when possible │
|
||||
│ │
|
||||
│ Write to: $DOCS_DIR/content.json │
|
||||
└─────────────────────────────────────────────────────────────────┘
|
||||
|
||||
┌─────────────────────────────────────────────────────────────────┐
|
||||
│ AGENT 3: Q&A / FAQ Generator │
|
||||
├─────────────────────────────────────────────────────────────────┤
|
||||
│ Task tool with: │
|
||||
│ subagent_type: "technical-writer" │
|
||||
│ run_in_background: true │
|
||||
│ prompt: | │
|
||||
│ # Q&A / FAQ GENERATION │
|
||||
│ │
|
||||
│ Read $DOCS_DIR/analysis.yml and PROJECT_DOCUMENTATION.md │
|
||||
│ to generate comprehensive Q&A. │
|
||||
│ │
|
||||
│ ## Output: faq.json │
|
||||
│ ```json │
|
||||
│ { │
|
||||
│ "categories": [ │
|
||||
│ { │
|
||||
│ "name": "Getting Started", │
|
||||
│ "questions": [ │
|
||||
│ { │
|
||||
│ "q": "How do I install [Project]?", │
|
||||
│ "a": "Clear, step-by-step answer" │
|
||||
│ } │
|
||||
│ ] │
|
||||
│ }, │
|
||||
│ { │
|
||||
│ "name": "Features", │
|
||||
│ "questions": [...] │
|
||||
│ }, │
|
||||
│ { │
|
||||
│ "name": "Technical", │
|
||||
│ "questions": [...] │
|
||||
│ }, │
|
||||
│ { │
|
||||
│ "name": "Pricing & Support", │
|
||||
│ "questions": [...] │
|
||||
│ } │
|
||||
│ ] │
|
||||
│ } │
|
||||
│ ``` │
|
||||
│ │
|
||||
│ Q&A Guidelines: │
|
||||
│ - 3-5 questions per category │
|
||||
│ - Anticipate real user questions │
|
||||
│ - Answers should be concise but complete │
|
||||
│ - Include code snippets where helpful │
|
||||
│ - Address common concerns and objections │
|
||||
│ │
|
||||
│ Write to: $DOCS_DIR/faq.json │
|
||||
└─────────────────────────────────────────────────────────────────┘
|
||||
|
||||
┌─────────────────────────────────────────────────────────────────┐
|
||||
│ AGENT 4: SEO & Meta Content │
|
||||
├─────────────────────────────────────────────────────────────────┤
|
||||
│ Task tool with: │
|
||||
│ subagent_type: "technical-writer" │
|
||||
│ run_in_background: true │
|
||||
│ prompt: | │
|
||||
│ # SEO & META CONTENT │
|
||||
│ │
|
||||
│ Read $DOCS_DIR/analysis.yml and create SEO content. │
|
||||
│ │
|
||||
│ ## Output: seo.json │
|
||||
│ ```json │
|
||||
│ { │
|
||||
│ "title": "Project Name - Tagline | Category", │
|
||||
│ "description": "150-160 char meta description", │
|
||||
│ "keywords": ["keyword1", "keyword2"], │
|
||||
│ "og": { │
|
||||
│ "title": "Open Graph title", │
|
||||
│ "description": "OG description", │
|
||||
│ "type": "website" │
|
||||
│ }, │
|
||||
│ "twitter": { │
|
||||
│ "card": "summary_large_image", │
|
||||
│ "title": "Twitter title", │
|
||||
│ "description": "Twitter description" │
|
||||
│ }, │
|
||||
│ "structured_data": { │
|
||||
│ "@type": "SoftwareApplication", │
|
||||
│ "name": "...", │
|
||||
│ "description": "..." │
|
||||
│ } │
|
||||
│ } │
|
||||
│ ``` │
|
||||
│ │
|
||||
│ Write to: $DOCS_DIR/seo.json │
|
||||
└─────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
#### 2.2: Wait for All Content Agents
|
||||
|
||||
```
|
||||
Use TaskOutput tool to wait for each agent:
|
||||
- TaskOutput with task_id from Agent 1 (branding), block: true
|
||||
- TaskOutput with task_id from Agent 2 (content), block: true
|
||||
- TaskOutput with task_id from Agent 3 (faq), block: true
|
||||
- TaskOutput with task_id from Agent 4 (seo), block: true
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### ═══════════════════════════════════════════════════════════════
|
||||
### PHASE 3: Generate Landing Page HTML
|
||||
### ═══════════════════════════════════════════════════════════════
|
||||
|
||||
#### 3.1: Generate Designer-Quality Landing Page
|
||||
|
||||
**Use Task tool with frontend-architect agent:**
|
||||
|
||||
```
|
||||
Task tool with:
|
||||
subagent_type: "frontend-architect"
|
||||
prompt: |
|
||||
# GENERATE LANDING PAGE HTML
|
||||
|
||||
Read these files and generate a stunning landing page:
|
||||
- $DOCS_DIR/branding.json (colors, typography, style)
|
||||
- $DOCS_DIR/content.json (hero, features, how-it-works)
|
||||
- $DOCS_DIR/faq.json (Q&A sections)
|
||||
- $DOCS_DIR/seo.json (meta tags)
|
||||
|
||||
## Output: $DOCS_DIR/landing.html
|
||||
|
||||
## Design Requirements
|
||||
|
||||
### Structure
|
||||
```html
|
||||
<!DOCTYPE html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<!-- SEO meta tags from seo.json -->
|
||||
<!-- Fonts: Google Fonts or system fonts -->
|
||||
<!-- Inline critical CSS -->
|
||||
</head>
|
||||
<body>
|
||||
<!-- Navigation (sticky) -->
|
||||
<nav>Logo | Links | CTA Button</nav>
|
||||
|
||||
<!-- Hero Section -->
|
||||
<section class="hero">
|
||||
<h1>Headline</h1>
|
||||
<p>Subheadline</p>
|
||||
<div class="cta-buttons">Primary | Secondary</div>
|
||||
<!-- Optional: Animated gradient background -->
|
||||
</section>
|
||||
|
||||
<!-- Social Proof / Stats -->
|
||||
<section class="stats">
|
||||
<div class="stat">Value + Label</div>
|
||||
</section>
|
||||
|
||||
<!-- Features Grid -->
|
||||
<section class="features">
|
||||
<h2>Features</h2>
|
||||
<div class="feature-grid">
|
||||
<!-- 3-column grid of feature cards -->
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<!-- How It Works -->
|
||||
<section class="how-it-works">
|
||||
<h2>How It Works</h2>
|
||||
<div class="steps">
|
||||
<!-- Numbered steps with visual flow -->
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<!-- Q&A / FAQ -->
|
||||
<section class="faq">
|
||||
<h2>Frequently Asked Questions</h2>
|
||||
<div class="faq-accordion">
|
||||
<!-- Expandable Q&A items -->
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<!-- CTA Section -->
|
||||
<section class="cta-final">
|
||||
<h2>Ready to Get Started?</h2>
|
||||
<button>Primary CTA</button>
|
||||
</section>
|
||||
|
||||
<!-- Footer -->
|
||||
<footer>
|
||||
Links | Copyright | Social
|
||||
</footer>
|
||||
|
||||
<!-- Inline JavaScript for interactions -->
|
||||
<script>
|
||||
// FAQ accordion
|
||||
// Smooth scroll
|
||||
// Dark mode toggle
|
||||
</script>
|
||||
</body>
|
||||
</html>
|
||||
```
|
||||
|
||||
### Visual Design Standards
|
||||
|
||||
**Hero Section**:
|
||||
- Full viewport height or 80vh minimum
|
||||
- Gradient or subtle pattern background
|
||||
- Large, bold headline (48-72px)
|
||||
- Clear visual hierarchy
|
||||
- Floating elements or subtle animation
|
||||
|
||||
**Feature Cards**:
|
||||
- Icon + Title + Description
|
||||
- Subtle hover effects (scale, shadow)
|
||||
- Consistent spacing (24-32px gaps)
|
||||
- 3-column on desktop, 1 on mobile
|
||||
|
||||
**How It Works**:
|
||||
- Visual step indicators (1, 2, 3)
|
||||
- Connecting lines or arrows
|
||||
- Icons or illustrations per step
|
||||
- Horizontal on desktop, vertical on mobile
|
||||
|
||||
**FAQ Accordion**:
|
||||
- Click to expand/collapse
|
||||
- Smooth animation (max-height transition)
|
||||
- Plus/minus or chevron indicator
|
||||
- Category grouping
|
||||
|
||||
**Micro-interactions**:
|
||||
- Button hover: scale(1.02) + shadow
|
||||
- Card hover: translateY(-4px) + shadow
|
||||
- Smooth scroll for anchor links
|
||||
- Fade-in on scroll (intersection observer)
|
||||
|
||||
### CSS Requirements
|
||||
|
||||
```css
|
||||
/* CSS Custom Properties from branding.json */
|
||||
:root {
|
||||
--color-primary: ...;
|
||||
--color-secondary: ...;
|
||||
--font-heading: ...;
|
||||
--radius: ...;
|
||||
}
|
||||
|
||||
/* Dark mode */
|
||||
@media (prefers-color-scheme: dark) {
|
||||
:root {
|
||||
--color-bg: var(--color-bg-dark);
|
||||
...
|
||||
}
|
||||
}
|
||||
|
||||
/* Responsive breakpoints */
|
||||
/* Mobile: < 640px */
|
||||
/* Tablet: 640-1024px */
|
||||
/* Desktop: > 1024px */
|
||||
```
|
||||
|
||||
### JavaScript Requirements
|
||||
- FAQ accordion functionality
|
||||
- Smooth scroll for navigation
|
||||
- Optional: Scroll-triggered animations
|
||||
- Dark mode toggle (optional)
|
||||
- Mobile menu toggle
|
||||
|
||||
### Performance
|
||||
- Single HTML file (no external dependencies)
|
||||
- Inline critical CSS
|
||||
- Minimal JavaScript
|
||||
- Optimized for Core Web Vitals
|
||||
- < 100KB total size
|
||||
|
||||
Write complete HTML to: $DOCS_DIR/landing.html
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### ═══════════════════════════════════════════════════════════════
|
||||
### PHASE 4: Finalization
|
||||
### ═══════════════════════════════════════════════════════════════
|
||||
|
||||
#### 4.1: Validate Generated Files
|
||||
|
||||
Verify all files exist:
|
||||
- `$DOCS_DIR/branding.json`
|
||||
- `$DOCS_DIR/content.json`
|
||||
- `$DOCS_DIR/faq.json`
|
||||
- `$DOCS_DIR/seo.json`
|
||||
- `$DOCS_DIR/landing.html`
|
||||
|
||||
#### 4.2: Display Completion Banner
|
||||
|
||||
```
|
||||
╔══════════════════════════════════════════════════════════════╗
|
||||
║ ✅ LANDING PAGE GENERATED SUCCESSFULLY ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ Output Directory: $DOCS_DIR ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ Files Created: ║
|
||||
║ 🎨 branding.json (Colors, typography, style guide) ║
|
||||
║ 📝 content.json (Hero, features, how-it-works) ║
|
||||
║ ❓ faq.json (Q&A content by category) ║
|
||||
║ 🔍 seo.json (Meta tags, Open Graph, Schema) ║
|
||||
║ 🌐 landing.html (Designer-quality landing page) ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ Landing Page Features: ║
|
||||
║ ✅ Hero with compelling headline + CTAs ║
|
||||
║ ✅ Feature grid with icons ║
|
||||
║ ✅ How It Works visual flow ║
|
||||
║ ✅ Interactive FAQ accordion ║
|
||||
║ ✅ Responsive (mobile-first) ║
|
||||
║ ✅ Dark mode support ║
|
||||
║ ✅ SEO optimized ║
|
||||
║ ✅ Single file, no dependencies ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ Next Steps: ║
|
||||
║ → Open landing.html in browser to preview ║
|
||||
║ → Customize colors in branding.json ║
|
||||
║ → Add real screenshots/images ║
|
||||
║ → Deploy to your hosting ║
|
||||
╚══════════════════════════════════════════════════════════════╝
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ARGUMENTS
|
||||
|
||||
| Argument | Default | Description |
|
||||
|----------|---------|-------------|
|
||||
| `[docs_dir]` | `docs` | Directory containing documentation from /eureka:index |
|
||||
| `--style` | `modern` | Design style: modern, minimal, bold, corporate |
|
||||
| `--theme` | `auto` | Color theme: auto, light, dark |
|
||||
|
||||
## EXAMPLES
|
||||
|
||||
```bash
|
||||
# Generate landing page from default docs directory
|
||||
/eureka:landing
|
||||
|
||||
# Generate from custom documentation directory
|
||||
/eureka:landing my-docs
|
||||
|
||||
# Generate with specific style
|
||||
/eureka:landing --style minimal
|
||||
|
||||
# Generate dark-only theme
|
||||
/eureka:landing --theme dark
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## DESIGN STYLE OPTIONS
|
||||
|
||||
### Modern (Default)
|
||||
- Gradient backgrounds
|
||||
- Rounded corners (12-16px)
|
||||
- Soft shadows
|
||||
- Vibrant accent colors
|
||||
- Floating elements
|
||||
|
||||
### Minimal
|
||||
- Clean white space
|
||||
- Thin borders
|
||||
- Muted colors
|
||||
- Typography-focused
|
||||
- Subtle interactions
|
||||
|
||||
### Bold
|
||||
- Strong colors
|
||||
- Large typography
|
||||
- High contrast
|
||||
- Geometric shapes
|
||||
- Impactful CTAs
|
||||
|
||||
### Corporate
|
||||
- Professional blues/grays
|
||||
- Structured layout
|
||||
- Trust indicators
|
||||
- Clean lines
|
||||
- Conservative animations
|
||||
|
||||
---
|
||||
|
||||
## OUTPUT STRUCTURE
|
||||
|
||||
```
|
||||
docs/
|
||||
├── analysis.yml (from /eureka:index)
|
||||
├── PROJECT_DOCUMENTATION.md
|
||||
├── API_REFERENCE.md
|
||||
├── COMPONENTS.md
|
||||
├── QUICK_REFERENCE.md
|
||||
├── index.html (documentation HTML)
|
||||
│
|
||||
├── branding.json (NEW - concept branding)
|
||||
├── content.json (NEW - marketing content)
|
||||
├── faq.json (NEW - Q&A content)
|
||||
├── seo.json (NEW - SEO metadata)
|
||||
└── landing.html (NEW - landing page)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## BRANDING SYSTEM
|
||||
|
||||
The generated branding.json provides a complete design system:
|
||||
|
||||
```json
|
||||
{
|
||||
"brand": {
|
||||
"name": "Project Name",
|
||||
"tagline": "Your compelling tagline",
|
||||
"value_proposition": "What makes it unique"
|
||||
},
|
||||
"colors": {
|
||||
"primary": "#6366f1",
|
||||
"secondary": "#8b5cf6",
|
||||
"accent": "#f59e0b",
|
||||
"background": "#ffffff",
|
||||
"background_dark": "#0f172a",
|
||||
"text": "#1e293b",
|
||||
"text_muted": "#64748b"
|
||||
},
|
||||
"typography": {
|
||||
"heading_font": "Inter, system-ui, sans-serif",
|
||||
"body_font": "Inter, system-ui, sans-serif",
|
||||
"mono_font": "JetBrains Mono, Consolas, monospace"
|
||||
},
|
||||
"style": {
|
||||
"border_radius": "12px",
|
||||
"shadow_sm": "0 1px 2px rgba(0,0,0,0.05)",
|
||||
"shadow_md": "0 4px 6px -1px rgba(0,0,0,0.1)",
|
||||
"shadow_lg": "0 10px 15px -3px rgba(0,0,0,0.1)",
|
||||
"gradient": "linear-gradient(135deg, #6366f1 0%, #8b5cf6 100%)"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
This can be used to:
|
||||
- Maintain consistent branding across all pages
|
||||
- Generate CSS custom properties
|
||||
- Create Figma/design tool exports
|
||||
- Build component libraries
|
||||
|
|
@ -0,0 +1,243 @@
|
|||
---
|
||||
description: Analyze codebase and generate project manifest from existing code
|
||||
allowed-tools: Read, Write, Bash, Glob, Grep, Task, AskUserQuestion
|
||||
---
|
||||
|
||||
# Analyze Codebase and Generate Manifest
|
||||
|
||||
Analyze the current codebase and generate all files needed for the guardrail workflow system.
|
||||
|
||||
## Arguments
|
||||
|
||||
- `$ARGUMENTS` - Optional flags:
|
||||
- `--force` - Overwrite existing manifest without asking
|
||||
- `--dry-run` - Preview manifest without writing
|
||||
- `--deep` - Use AI agent for deeper analysis
|
||||
- `<name>` - Custom project name
|
||||
|
||||
## Generated Files
|
||||
|
||||
This command creates:
|
||||
1. `project_manifest.json` - Entity definitions and dependencies
|
||||
2. `.workflow/index.yml` - Version tracking index
|
||||
3. `.workflow/versions/` - Directory for version snapshots
|
||||
|
||||
## Quick Execution (Default)
|
||||
|
||||
### Step 1: Run the Python analyzer script
|
||||
```bash
|
||||
python3 skills/guardrail-orchestrator/scripts/analyze_codebase.py --path . $ARGUMENTS
|
||||
```
|
||||
|
||||
If the script succeeds, continue to Step 2.
|
||||
|
||||
### Step 2: Initialize Workflow Directory Structure [MANDATORY]
|
||||
```bash
|
||||
# Create workflow directory structure
|
||||
mkdir -p .workflow/versions
|
||||
|
||||
# Create index.yml if it doesn't exist
|
||||
if [ ! -f .workflow/index.yml ]; then
|
||||
cat > .workflow/index.yml << 'EOF'
|
||||
versions: []
|
||||
latest_version: null
|
||||
total_versions: 0
|
||||
EOF
|
||||
echo "Created .workflow/index.yml"
|
||||
fi
|
||||
```
|
||||
|
||||
### Step 3: Display Summary
|
||||
```
|
||||
╔══════════════════════════════════════════════════════════════╗
|
||||
║ ✅ GUARDRAIL INITIALIZED ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ Files Created: ║
|
||||
║ ✓ project_manifest.json ║
|
||||
║ ✓ .workflow/index.yml ║
|
||||
║ ✓ .workflow/versions/ ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ Ready to use: ║
|
||||
║ /workflow:spawn <feature> Start a new feature ║
|
||||
║ /guardrail:status Check project status ║
|
||||
╚══════════════════════════════════════════════════════════════╝
|
||||
```
|
||||
|
||||
## Deep Analysis Mode (--deep flag)
|
||||
|
||||
**Use the Task tool to spawn an Explore agent for comprehensive codebase analysis**
|
||||
|
||||
Use Task tool with:
|
||||
subagent_type: "Explore"
|
||||
prompt: |
|
||||
Analyze this codebase thoroughly and return structured information about:
|
||||
|
||||
1. **Pages** (Next.js App Router):
|
||||
- Find all page.tsx files in app/ directory
|
||||
- Extract route paths from file locations
|
||||
- Identify components imported/used
|
||||
- Identify API dependencies (fetch calls)
|
||||
|
||||
2. **Components**:
|
||||
- Find all .tsx files in app/components/
|
||||
- Extract component names and exports
|
||||
- Extract prop interfaces/types
|
||||
- Identify child component dependencies
|
||||
|
||||
3. **API Routes**:
|
||||
- Find all route.ts files in app/api/
|
||||
- Extract HTTP methods (GET, POST, PUT, DELETE, PATCH)
|
||||
- Identify request/response types
|
||||
- Extract path parameters
|
||||
|
||||
4. **Database/Types**:
|
||||
- Find type definitions in app/lib/
|
||||
- Extract interfaces and type aliases
|
||||
- Identify database schemas/tables
|
||||
|
||||
5. **Dependencies**:
|
||||
- Which components are used by which pages
|
||||
- Which APIs are called by which components
|
||||
- Which database tables are used by which APIs
|
||||
|
||||
Return the analysis as structured JSON sections.
|
||||
|
||||
### Phase 2: Generate Manifest
|
||||
|
||||
Based on the analysis, create `project_manifest.json` with this structure:
|
||||
|
||||
```json
|
||||
{
|
||||
"project": {
|
||||
"name": "<project-name>",
|
||||
"version": "1.0.0",
|
||||
"created_at": "<ISO timestamp>",
|
||||
"description": "<inferred from package.json or README>"
|
||||
},
|
||||
"state": {
|
||||
"current_phase": "IMPLEMENTATION_PHASE",
|
||||
"approval_status": {
|
||||
"manifest_approved": true,
|
||||
"approved_by": "analyzer",
|
||||
"approved_at": "<ISO timestamp>"
|
||||
},
|
||||
"revision_history": [
|
||||
{
|
||||
"action": "MANIFEST_GENERATED",
|
||||
"timestamp": "<ISO timestamp>",
|
||||
"details": "Generated from existing codebase analysis"
|
||||
}
|
||||
]
|
||||
},
|
||||
"entities": {
|
||||
"pages": [
|
||||
{
|
||||
"id": "page_<name>",
|
||||
"path": "/<route>",
|
||||
"file_path": "app/<path>/page.tsx",
|
||||
"status": "IMPLEMENTED",
|
||||
"description": "<inferred>",
|
||||
"components": ["comp_<name>", ...],
|
||||
"data_dependencies": ["api_<name>", ...]
|
||||
}
|
||||
],
|
||||
"components": [
|
||||
{
|
||||
"id": "comp_<name>",
|
||||
"name": "<ComponentName>",
|
||||
"file_path": "app/components/<Name>.tsx",
|
||||
"status": "IMPLEMENTED",
|
||||
"description": "<inferred from component>",
|
||||
"props": {
|
||||
"<propName>": {
|
||||
"type": "<type>",
|
||||
"optional": true|false,
|
||||
"description": "<if available>"
|
||||
}
|
||||
}
|
||||
}
|
||||
],
|
||||
"api_endpoints": [
|
||||
{
|
||||
"id": "api_<action>_<resource>",
|
||||
"path": "/api/<path>",
|
||||
"method": "GET|POST|PUT|DELETE|PATCH",
|
||||
"file_path": "app/api/<path>/route.ts",
|
||||
"status": "IMPLEMENTED",
|
||||
"description": "<inferred>",
|
||||
"request": {
|
||||
"params": {},
|
||||
"query": {},
|
||||
"body": {}
|
||||
},
|
||||
"response": {
|
||||
"type": "<type>",
|
||||
"description": "<description>"
|
||||
}
|
||||
}
|
||||
],
|
||||
"database_tables": [
|
||||
{
|
||||
"id": "table_<name>",
|
||||
"name": "<tableName>",
|
||||
"file_path": "app/lib/db.ts",
|
||||
"status": "IMPLEMENTED",
|
||||
"description": "<description>",
|
||||
"columns": {}
|
||||
}
|
||||
]
|
||||
},
|
||||
"dependencies": {
|
||||
"component_to_page": {},
|
||||
"api_to_component": {},
|
||||
"table_to_api": {}
|
||||
},
|
||||
"types": {}
|
||||
}
|
||||
```
|
||||
|
||||
### Phase 3: Entity Naming Conventions
|
||||
|
||||
Use these ID formats:
|
||||
- **Pages**: `page_<name>` (e.g., `page_home`, `page_tasks`, `page_task_detail`)
|
||||
- **Components**: `comp_<snake_case>` (e.g., `comp_task_list`, `comp_filter_bar`)
|
||||
- **APIs**: `api_<action>_<resource>` (e.g., `api_list_tasks`, `api_create_task`)
|
||||
- **Tables**: `table_<name>` (e.g., `table_tasks`, `table_users`)
|
||||
|
||||
### Phase 4: Write Manifest
|
||||
|
||||
1. Write the generated manifest to `project_manifest.json`
|
||||
2. Validate JSON syntax
|
||||
3. Display summary:
|
||||
|
||||
```
|
||||
╔══════════════════════════════════════════════════════════════╗
|
||||
║ 📊 MANIFEST GENERATED ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ Project: <name> ║
|
||||
║ Generated: <timestamp> ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ ENTITIES DISCOVERED ║
|
||||
║ 📄 Pages: X ║
|
||||
║ 🧩 Components: X ║
|
||||
║ 🔌 APIs: X ║
|
||||
║ 🗄️ Tables: X ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ Status: All entities marked as IMPLEMENTED ║
|
||||
║ Phase: IMPLEMENTATION_PHASE ║
|
||||
╚══════════════════════════════════════════════════════════════╝
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
If manifest already exists, ask user:
|
||||
1. **Overwrite** - Replace existing manifest
|
||||
2. **Merge** - Add new entities, keep existing
|
||||
3. **Cancel** - Abort operation
|
||||
|
||||
## Notes
|
||||
|
||||
- All discovered entities are marked as `IMPLEMENTED` since they already exist
|
||||
- Project starts in `IMPLEMENTATION_PHASE` since code exists
|
||||
- Use this command to bring existing projects under guardrail management
|
||||
- After generation, use `/guardrail:validate` to verify manifest accuracy
|
||||
|
|
@ -0,0 +1,47 @@
|
|||
---
|
||||
description: Approve design and transition to IMPLEMENTATION_PHASE (Reviewer mode)
|
||||
allowed-tools: Read, Write, Bash
|
||||
---
|
||||
|
||||
# Approve Design (Reviewer Mode)
|
||||
|
||||
✅ **REVIEWER MODE ACTIVATED**
|
||||
|
||||
Approve the current design and enable implementation.
|
||||
|
||||
## CRITICAL RULES
|
||||
|
||||
You are acting as the **REVIEWER AGENT**.
|
||||
|
||||
✅ **ALLOWED**:
|
||||
- Read any file
|
||||
- Update approval status in manifest
|
||||
- Transition phases
|
||||
|
||||
❌ **BLOCKED**:
|
||||
- Write ANY code files
|
||||
- You cannot implement anything
|
||||
|
||||
## Steps
|
||||
|
||||
1. **Verify Phase**: Must be in `DESIGN_REVIEW`
|
||||
|
||||
2. **Run Full Validation**:
|
||||
```bash
|
||||
python3 "$CLAUDE_PROJECT_DIR/skills/guardrail-orchestrator/scripts/validate_manifest.py" --strict
|
||||
```
|
||||
|
||||
3. **If Valid**, update manifest:
|
||||
- Set `state.approval_status.manifest_approved = true`
|
||||
- Set `state.approval_status.approved_by = "reviewer"`
|
||||
- Set `state.approval_status.approved_at = <current timestamp>`
|
||||
|
||||
4. **Transition to Implementation**:
|
||||
```bash
|
||||
python3 "$CLAUDE_PROJECT_DIR/skills/guardrail-orchestrator/scripts/transition_phase.py" --to IMPLEMENTATION_PHASE
|
||||
```
|
||||
|
||||
5. **Show Results**:
|
||||
- List all entities now with status `APPROVED`
|
||||
- Explain that code can now be written for these entities
|
||||
- Suggest `/guardrail:implement` to start
|
||||
|
|
@ -0,0 +1,81 @@
|
|||
---
|
||||
description: Design a new feature by adding entities to manifest (Architect mode)
|
||||
allowed-tools: Read, Write, Bash
|
||||
---
|
||||
|
||||
# Design Feature (Architect Mode)
|
||||
|
||||
🏗️ **ARCHITECT MODE ACTIVATED**
|
||||
|
||||
Design the feature: "$ARGUMENTS"
|
||||
|
||||
## CRITICAL RULES
|
||||
|
||||
You are now acting as the **ARCHITECT AGENT**.
|
||||
|
||||
✅ **ALLOWED**:
|
||||
- Read any file
|
||||
- Write to `project_manifest.json` ONLY
|
||||
- Run validation scripts
|
||||
|
||||
❌ **BLOCKED**:
|
||||
- Write ANY code files (.ts, .tsx, .css, .sql, .js, .jsx)
|
||||
- You CANNOT write implementation code yet
|
||||
|
||||
## Workflow
|
||||
|
||||
1. **Verify Phase**: Check `project_manifest.json` - must be in `DESIGN_PHASE`
|
||||
|
||||
2. **Analyze Requirements**: Break down "$ARGUMENTS" into:
|
||||
- Pages needed (routes/screens)
|
||||
- Components needed (UI elements)
|
||||
- API endpoints needed (backend routes)
|
||||
- Database tables needed (data storage)
|
||||
|
||||
3. **Define Each Entity** in manifest with:
|
||||
- Unique ID following naming convention
|
||||
- Complete specification (props, schemas, columns)
|
||||
- `status: "DEFINED"`
|
||||
- File path where it will be implemented
|
||||
|
||||
4. **Update Manifest**: Add all entities to `project_manifest.json`
|
||||
|
||||
5. **Validate**: Run `python3 skills/guardrail-orchestrator/scripts/validate_manifest.py`
|
||||
|
||||
6. **Summarize**: List what was added and suggest `/guardrail:review`
|
||||
|
||||
## Entity Templates
|
||||
|
||||
### Page
|
||||
```json
|
||||
{
|
||||
"id": "page_[name]",
|
||||
"path": "/[route]",
|
||||
"file_path": "src/pages/[name]/index.tsx",
|
||||
"status": "DEFINED",
|
||||
"components": [],
|
||||
"data_dependencies": []
|
||||
}
|
||||
```
|
||||
|
||||
### Component
|
||||
```json
|
||||
{
|
||||
"id": "comp_[name]",
|
||||
"name": "[PascalCase]",
|
||||
"file_path": "src/components/[Name]/index.tsx",
|
||||
"status": "DEFINED",
|
||||
"props": {}
|
||||
}
|
||||
```
|
||||
|
||||
### API Endpoint
|
||||
```json
|
||||
{
|
||||
"id": "api_[action]_[resource]",
|
||||
"path": "/api/v1/[resource]",
|
||||
"method": "GET|POST|PUT|DELETE",
|
||||
"file_path": "src/api/[resource]/[action].ts",
|
||||
"status": "DEFINED"
|
||||
}
|
||||
```
|
||||
|
|
@ -0,0 +1,74 @@
|
|||
---
|
||||
description: Implement an approved entity from the manifest
|
||||
allowed-tools: Read, Write, Bash
|
||||
---
|
||||
|
||||
# Implement Entity
|
||||
|
||||
Implement the entity: "$ARGUMENTS"
|
||||
|
||||
## CRITICAL RULES
|
||||
|
||||
⚠️ **GUARDRAIL ENFORCEMENT ACTIVE**
|
||||
|
||||
You can ONLY write to files that:
|
||||
1. Are defined in `project_manifest.json`
|
||||
2. Have status = `APPROVED`
|
||||
3. Match the `file_path` in the manifest EXACTLY
|
||||
|
||||
## Steps
|
||||
|
||||
1. **Verify Phase**: Must be in `IMPLEMENTATION_PHASE`
|
||||
|
||||
2. **Find Entity** in manifest:
|
||||
- If "$ARGUMENTS" is `--all`: implement all APPROVED entities
|
||||
- Otherwise: find the specific entity by ID
|
||||
|
||||
3. **For Each Entity**:
|
||||
|
||||
a. **Load Definition** from manifest
|
||||
|
||||
b. **Verify Status** is `APPROVED`
|
||||
|
||||
c. **Generate Code** matching the specification:
|
||||
- Props must match manifest exactly
|
||||
- Types must match manifest exactly
|
||||
- File path must match `file_path` in manifest
|
||||
|
||||
d. **Write File** to the exact path in manifest
|
||||
|
||||
e. **Run Validations**:
|
||||
```bash
|
||||
npm run lint --if-present
|
||||
npm run type-check --if-present
|
||||
```
|
||||
|
||||
4. **Status Updates** (handled by post-hook):
|
||||
- Entity status changes to `IMPLEMENTED`
|
||||
- Timestamp recorded
|
||||
|
||||
## Code Templates
|
||||
|
||||
### Component (Frontend)
|
||||
```tsx
|
||||
import React from 'react';
|
||||
|
||||
interface [Name]Props {
|
||||
// From manifest.props
|
||||
}
|
||||
|
||||
export const [Name]: React.FC<[Name]Props> = (props) => {
|
||||
return (
|
||||
// Implementation
|
||||
);
|
||||
};
|
||||
```
|
||||
|
||||
### API Endpoint (Backend)
|
||||
```typescript
|
||||
import { Request, Response } from 'express';
|
||||
|
||||
export async function handler(req: Request, res: Response) {
|
||||
// From manifest.request/response schemas
|
||||
}
|
||||
```
|
||||
|
|
@ -0,0 +1,67 @@
|
|||
---
|
||||
description: Initialize a new guardrailed project with manifest
|
||||
allowed-tools: Bash, Write, Read
|
||||
---
|
||||
|
||||
# Initialize Guardrailed Project
|
||||
|
||||
Initialize a new project called "$ARGUMENTS" with guardrail enforcement and workflow system.
|
||||
|
||||
## Generated Files
|
||||
|
||||
This command creates:
|
||||
1. `project_manifest.json` - Entity definitions and dependencies
|
||||
2. `.workflow/index.yml` - Version tracking index
|
||||
3. `.workflow/versions/` - Directory for version snapshots
|
||||
|
||||
## Steps
|
||||
|
||||
### Step 1: Run the initialization script
|
||||
```bash
|
||||
python3 skills/guardrail-orchestrator/scripts/init_project.py --name "$ARGUMENTS" --path .
|
||||
```
|
||||
|
||||
### Step 2: Initialize Workflow Directory Structure [MANDATORY]
|
||||
```bash
|
||||
# Create workflow directory structure
|
||||
mkdir -p .workflow/versions
|
||||
|
||||
# Create index.yml if it doesn't exist
|
||||
if [ ! -f .workflow/index.yml ]; then
|
||||
cat > .workflow/index.yml << 'EOF'
|
||||
versions: []
|
||||
latest_version: null
|
||||
total_versions: 0
|
||||
EOF
|
||||
fi
|
||||
```
|
||||
|
||||
### Step 3: Verify and Display Summary
|
||||
```bash
|
||||
# Verify files exist
|
||||
ls project_manifest.json .workflow/index.yml
|
||||
```
|
||||
|
||||
Display:
|
||||
```
|
||||
╔══════════════════════════════════════════════════════════════╗
|
||||
║ ✅ PROJECT INITIALIZED ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ Project: $ARGUMENTS ║
|
||||
║ Phase: DESIGN_PHASE ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ Files Created: ║
|
||||
║ ✓ project_manifest.json ║
|
||||
║ ✓ .workflow/index.yml ║
|
||||
║ ✓ .workflow/versions/ ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ Next Steps: ║
|
||||
║ /guardrail:design Design features in manifest ║
|
||||
║ /workflow:spawn <feat> Start automated workflow ║
|
||||
╚══════════════════════════════════════════════════════════════╝
|
||||
```
|
||||
|
||||
## Notes
|
||||
- Project starts in **DESIGN_PHASE** (manifest edits only)
|
||||
- Use `/guardrail:design` for manual design workflow
|
||||
- Use `/workflow:spawn` for automated design + implementation
|
||||
|
|
@ -0,0 +1,32 @@
|
|||
---
|
||||
description: Request design review and transition to DESIGN_REVIEW phase
|
||||
allowed-tools: Read, Write, Bash
|
||||
---
|
||||
|
||||
# Request Design Review
|
||||
|
||||
Transition the project from DESIGN_PHASE to DESIGN_REVIEW.
|
||||
|
||||
## Steps
|
||||
|
||||
1. **Validate Manifest**:
|
||||
```bash
|
||||
python3 "$CLAUDE_PROJECT_DIR/skills/guardrail-orchestrator/scripts/validate_manifest.py" --strict
|
||||
```
|
||||
|
||||
2. **If Valid**, transition phase:
|
||||
```bash
|
||||
python3 "$CLAUDE_PROJECT_DIR/skills/guardrail-orchestrator/scripts/transition_phase.py" --to DESIGN_REVIEW
|
||||
```
|
||||
|
||||
3. **Show Review Checklist**:
|
||||
- [ ] All pages have at least one component
|
||||
- [ ] All components have defined props with types
|
||||
- [ ] All APIs have request/response schemas
|
||||
- [ ] All database tables have primary keys
|
||||
- [ ] No orphan components
|
||||
- [ ] No circular dependencies
|
||||
|
||||
4. **Explain Next Steps**:
|
||||
- Use `/guardrail:approve` to approve and move to implementation
|
||||
- Use `/guardrail:reject <feedback>` to send back for fixes
|
||||
|
|
@ -0,0 +1,27 @@
|
|||
---
|
||||
description: Show current project phase, entity counts, and pending work
|
||||
allowed-tools: Read, Bash
|
||||
---
|
||||
|
||||
# Guardrail Status
|
||||
|
||||
Display the current guardrail project status.
|
||||
|
||||
## Steps
|
||||
|
||||
1. Read `project_manifest.json`
|
||||
|
||||
2. Display:
|
||||
- **Current Phase**: `state.current_phase`
|
||||
- **Approval Status**: `state.approval_status.manifest_approved`
|
||||
- **Entity Counts**:
|
||||
- Pages: count by status (DEFINED/APPROVED/IMPLEMENTED)
|
||||
- Components: count by status
|
||||
- API Endpoints: count by status
|
||||
- Database Tables: count by status
|
||||
- **Recent History**: last 5 items from `state.revision_history`
|
||||
|
||||
3. Show available actions for current phase:
|
||||
- DESIGN_PHASE: Can use `/guardrail:design`, then `/guardrail:review`
|
||||
- DESIGN_REVIEW: Can use `/guardrail:approve` or `/guardrail:reject`
|
||||
- IMPLEMENTATION_PHASE: Can use `/guardrail:implement`
|
||||
|
|
@ -0,0 +1,29 @@
|
|||
---
|
||||
description: Validate manifest integrity and completeness
|
||||
allowed-tools: Bash, Read
|
||||
---
|
||||
|
||||
# Validate Manifest
|
||||
|
||||
Run validation checks on `project_manifest.json`.
|
||||
|
||||
## Command
|
||||
|
||||
```bash
|
||||
python3 "$CLAUDE_PROJECT_DIR/skills/guardrail-orchestrator/scripts/validate_manifest.py" $ARGUMENTS
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
- No arguments: Basic validation
|
||||
- `--strict`: Treat warnings as errors
|
||||
|
||||
## What It Checks
|
||||
|
||||
1. **Structure**: Required top-level keys exist
|
||||
2. **Pages**: Have paths, components, file_paths
|
||||
3. **Components**: Have props with types, valid dependencies
|
||||
4. **APIs**: Have methods, paths, request/response schemas
|
||||
5. **Database**: Tables have primary keys, valid foreign keys
|
||||
6. **Dependencies**: No orphans, no circular references
|
||||
7. **Naming**: Follows conventions
|
||||
|
|
@ -0,0 +1,57 @@
|
|||
---
|
||||
description: Verify implementation matches manifest specifications
|
||||
allowed-tools: Bash, Read
|
||||
---
|
||||
|
||||
# Verify Implementation
|
||||
|
||||
Run verification to ensure all implemented code matches the manifest specifications.
|
||||
|
||||
## Command
|
||||
|
||||
```bash
|
||||
python3 "$CLAUDE_PROJECT_DIR/skills/guardrail-orchestrator/scripts/verify_implementation.py" --project-root "$CLAUDE_PROJECT_DIR" $ARGUMENTS
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
- No arguments: Basic verification
|
||||
- `--verbose` or `-v`: Include warnings
|
||||
- `--json`: Output as JSON for programmatic use
|
||||
|
||||
## What It Checks
|
||||
|
||||
For each entity in the manifest:
|
||||
|
||||
### Components
|
||||
- File exists at specified `file_path`
|
||||
- Component name is exported
|
||||
- Props interface matches manifest definition
|
||||
|
||||
### Pages
|
||||
- File exists at specified `file_path`
|
||||
- Has `export default` (Next.js requirement)
|
||||
- Uses specified component dependencies
|
||||
|
||||
### API Endpoints
|
||||
- File exists at specified `file_path`
|
||||
- HTTP method handler exists (GET, POST, PUT, DELETE)
|
||||
- Request parameters are handled
|
||||
|
||||
### Database Tables
|
||||
- File exists at specified `file_path`
|
||||
- Column definitions present
|
||||
- CRUD operations implemented
|
||||
|
||||
## Example Output
|
||||
|
||||
```
|
||||
✅ [component] comp_button
|
||||
File: app/components/Button.tsx
|
||||
|
||||
❌ [component] comp_missing
|
||||
File: app/components/Missing.tsx
|
||||
❌ ERROR: File not found
|
||||
|
||||
SUMMARY: 17/18 passed, 1 failed, 3 warnings
|
||||
```
|
||||
|
|
@ -0,0 +1,87 @@
|
|||
---
|
||||
description: Approve a workflow gate (design or implementation)
|
||||
allowed-tools: Read, Write, Bash
|
||||
---
|
||||
|
||||
# Approve Workflow Gate
|
||||
|
||||
Approve gate: "$ARGUMENTS"
|
||||
|
||||
## Valid Gates
|
||||
- `design` - Approve the design phase (entities + tasks)
|
||||
- `implementation` - Approve the implementation phase (all code)
|
||||
|
||||
## Steps
|
||||
|
||||
### 1. Validate Gate
|
||||
- If "$ARGUMENTS" is not `design` or `implementation`: STOP and show usage
|
||||
|
||||
### 2. Check Workflow State
|
||||
```bash
|
||||
python3 skills/guardrail-orchestrator/scripts/workflow_manager.py exists
|
||||
```
|
||||
|
||||
If no active workflow:
|
||||
```
|
||||
❌ No active workflow found.
|
||||
Start a new workflow with: /workflow:spawn "feature name"
|
||||
```
|
||||
|
||||
### 3. Verify Current Phase
|
||||
|
||||
**For design approval**:
|
||||
- Current phase must be `AWAITING_DESIGN_APPROVAL`
|
||||
- If not: Report error with current phase
|
||||
|
||||
**For implementation approval**:
|
||||
- Current phase must be `AWAITING_IMPL_APPROVAL`
|
||||
- If not: Report error with current phase
|
||||
|
||||
### 4. Execute Approval
|
||||
|
||||
```bash
|
||||
python3 skills/guardrail-orchestrator/scripts/workflow_manager.py approve $ARGUMENTS
|
||||
```
|
||||
|
||||
### 5. Transition to Next Phase
|
||||
|
||||
**If design approved**:
|
||||
```bash
|
||||
python3 skills/guardrail-orchestrator/scripts/workflow_manager.py transition DESIGN_APPROVED
|
||||
python3 skills/guardrail-orchestrator/scripts/workflow_manager.py transition IMPLEMENTING
|
||||
```
|
||||
|
||||
**If implementation approved**:
|
||||
```bash
|
||||
python3 skills/guardrail-orchestrator/scripts/workflow_manager.py transition IMPL_APPROVED
|
||||
python3 skills/guardrail-orchestrator/scripts/workflow_manager.py transition COMPLETING
|
||||
```
|
||||
|
||||
### 6. Report
|
||||
|
||||
**Design Approved**:
|
||||
```
|
||||
╔══════════════════════════════════════════════════════════════╗
|
||||
║ ✅ DESIGN APPROVED ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ The design has been approved. Implementation will begin. ║
|
||||
║ ║
|
||||
║ Next steps: ║
|
||||
║ /workflow:frontend --next Start frontend tasks ║
|
||||
║ /workflow:backend --next Start backend tasks ║
|
||||
║ /workflow:resume Auto-continue workflow ║
|
||||
╚══════════════════════════════════════════════════════════════╝
|
||||
```
|
||||
|
||||
**Implementation Approved**:
|
||||
```
|
||||
╔══════════════════════════════════════════════════════════════╗
|
||||
║ ✅ IMPLEMENTATION APPROVED ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ All implementations have been approved. ║
|
||||
║ ║
|
||||
║ Next steps: ║
|
||||
║ /workflow:complete --all Mark all tasks as done ║
|
||||
║ /workflow:resume Auto-complete workflow ║
|
||||
╚══════════════════════════════════════════════════════════════╝
|
||||
```
|
||||
|
|
@ -0,0 +1,85 @@
|
|||
---
|
||||
description: Implement backend tasks (Backend agent)
|
||||
allowed-tools: Read, Write, Edit, Bash
|
||||
---
|
||||
|
||||
# Backend Agent - Implementation Mode
|
||||
|
||||
⚙️ **BACKEND AGENT ACTIVATED**
|
||||
|
||||
Implement task: "$ARGUMENTS"
|
||||
|
||||
## CRITICAL RULES
|
||||
|
||||
You are now the **BACKEND AGENT**.
|
||||
|
||||
✅ **ALLOWED**:
|
||||
- Read any file
|
||||
- Write new files (API routes, DB)
|
||||
- Edit existing backend files
|
||||
- Run Bash (build, lint, type-check, tests)
|
||||
|
||||
✅ **ALLOWED FILES**:
|
||||
- `app/api/**/*`
|
||||
- `app/lib/**/*`
|
||||
- `prisma/**/*`
|
||||
- `db/**/*`
|
||||
|
||||
## Workflow
|
||||
|
||||
### Step 1: Load Task
|
||||
First, get the version-specific tasks directory:
|
||||
```bash
|
||||
TASKS_DIR=$(python3 skills/guardrail-orchestrator/scripts/version_manager.py tasks-dir)
|
||||
```
|
||||
|
||||
Read the task file: `$TASKS_DIR/$ARGUMENTS.yml`
|
||||
- If "$ARGUMENTS" is `--next`: find first task with `agent: backend` and `status: pending`
|
||||
|
||||
### Step 2: Update Workflow State
|
||||
```bash
|
||||
python3 skills/guardrail-orchestrator/scripts/workflow_manager.py task <task_id> in_progress
|
||||
```
|
||||
|
||||
### Step 3: Verify Prerequisites
|
||||
- Check entity is `APPROVED` in `project_manifest.json`
|
||||
- Check all `dependencies` tasks are `completed`
|
||||
- If blocked:
|
||||
```bash
|
||||
python3 skills/guardrail-orchestrator/scripts/workflow_manager.py task <task_id> blocked
|
||||
```
|
||||
Stop and report blocker.
|
||||
|
||||
### Step 4: Implement
|
||||
For each file in `file_paths`:
|
||||
1. Read manifest entity specification
|
||||
2. Generate code matching spec exactly:
|
||||
- HTTP methods must match manifest
|
||||
- Request params must match manifest
|
||||
- Response types must match manifest
|
||||
3. Follow existing project patterns
|
||||
|
||||
### Step 5: Validate
|
||||
Run validations:
|
||||
```bash
|
||||
npm run lint
|
||||
npm run build
|
||||
```
|
||||
|
||||
### Step 6: Update Task Status
|
||||
Update the task file:
|
||||
```yaml
|
||||
status: review
|
||||
completed_at: <current timestamp>
|
||||
```
|
||||
|
||||
Update workflow state:
|
||||
```bash
|
||||
python3 skills/guardrail-orchestrator/scripts/workflow_manager.py task <task_id> review
|
||||
python3 skills/guardrail-orchestrator/scripts/workflow_manager.py progress --tasks-impl <count>
|
||||
```
|
||||
|
||||
### Step 7: Report
|
||||
- List implemented files
|
||||
- Show validation results
|
||||
- Suggest: `/workflow:review $ARGUMENTS`
|
||||
|
|
@ -0,0 +1,66 @@
|
|||
---
|
||||
description: Mark approved task as completed
|
||||
allowed-tools: Read, Write, Bash
|
||||
---
|
||||
|
||||
# Complete Task
|
||||
|
||||
Mark task "$ARGUMENTS" as completed.
|
||||
|
||||
## Prerequisites
|
||||
- Task must have `status: approved`
|
||||
- All acceptance criteria verified by reviewer
|
||||
|
||||
## Steps
|
||||
|
||||
### 1. Read Task
|
||||
First, get the version-specific tasks directory:
|
||||
```bash
|
||||
TASKS_DIR=$(python3 skills/guardrail-orchestrator/scripts/version_manager.py tasks-dir)
|
||||
```
|
||||
|
||||
Read `$TASKS_DIR/$ARGUMENTS.yml`
|
||||
|
||||
### 2. Verify Status
|
||||
- If `status` is NOT `approved`: STOP and report error
|
||||
- If `status` is `approved`: proceed
|
||||
|
||||
### 3. Update Task
|
||||
Update the task file with:
|
||||
```yaml
|
||||
status: completed
|
||||
completed_at: <current timestamp>
|
||||
```
|
||||
|
||||
### 4. Update Workflow State
|
||||
```bash
|
||||
python3 skills/guardrail-orchestrator/scripts/workflow_manager.py task <task_id> completed
|
||||
python3 skills/guardrail-orchestrator/scripts/workflow_manager.py progress --tasks-completed <count>
|
||||
```
|
||||
|
||||
### 5. Update Manifest (if applicable)
|
||||
For each entity in `entity_ids`:
|
||||
- Update entity status to `IMPLEMENTED` in `project_manifest.json`
|
||||
|
||||
### 6. Check Workflow Completion
|
||||
Check if all tasks are now completed:
|
||||
```bash
|
||||
python3 skills/guardrail-orchestrator/scripts/workflow_manager.py status
|
||||
```
|
||||
|
||||
If all tasks completed, transition to implementation approval:
|
||||
```bash
|
||||
python3 skills/guardrail-orchestrator/scripts/workflow_manager.py transition AWAITING_IMPL_APPROVAL
|
||||
```
|
||||
|
||||
### 7. Report
|
||||
```
|
||||
✅ Task completed: $ARGUMENTS
|
||||
|
||||
Entities implemented:
|
||||
- <entity_id_1>
|
||||
- <entity_id_2>
|
||||
|
||||
Next: /workflow:status to see remaining tasks
|
||||
/workflow:complete --all to complete all approved tasks
|
||||
```
|
||||
|
|
@ -0,0 +1,476 @@
|
|||
---
|
||||
description: Design system architecture with ER diagram, API contracts, and UI structure
|
||||
allowed-tools: Read, Write, Edit, Bash, Task, TodoWrite
|
||||
---
|
||||
|
||||
# Workflow Design - System Architecture Phase
|
||||
|
||||
**Input**: "$ARGUMENTS"
|
||||
|
||||
---
|
||||
|
||||
## PURPOSE
|
||||
|
||||
This command creates a comprehensive **design document** that serves as the source of truth for implementation. It defines:
|
||||
|
||||
1. **Data Layer** - ER diagram with models, fields, relations
|
||||
2. **API Layer** - REST endpoints with request/response contracts
|
||||
3. **UI Layer** - Pages and components with data requirements
|
||||
4. **Dependency Graph** - Layered execution order for parallel tasks
|
||||
|
||||
---
|
||||
|
||||
## ⛔ CRITICAL RULES
|
||||
|
||||
### MUST DO
|
||||
1. **MUST** create `design_document.yml` with ALL layers defined
|
||||
2. **MUST** run `validate_design.py` to generate dependency graph
|
||||
3. **MUST** verify no circular dependencies before proceeding
|
||||
4. **MUST** show layered execution plan to user
|
||||
|
||||
### CANNOT DO
|
||||
1. **CANNOT** create tasks without design document
|
||||
2. **CANNOT** skip validation step
|
||||
3. **CANNOT** proceed if validation fails
|
||||
|
||||
---
|
||||
|
||||
## EXECUTION FLOW
|
||||
|
||||
### ═══════════════════════════════════════════════════════════════
|
||||
### STEP 1: Initialize Design Session
|
||||
### ═══════════════════════════════════════════════════════════════
|
||||
|
||||
#### 1.1: Get Current Version
|
||||
```bash
|
||||
# Get active version from workflow
|
||||
VERSION_ID=$(cat .workflow/current.yml 2>/dev/null | grep "active_version:" | awk '{print $2}')
|
||||
if [ -z "$VERSION_ID" ]; then
|
||||
echo "ERROR: No active workflow. Run /workflow:spawn first"
|
||||
exit 1
|
||||
fi
|
||||
echo "VERSION_ID=$VERSION_ID"
|
||||
```
|
||||
|
||||
#### 1.2: Create Design Directory
|
||||
```bash
|
||||
mkdir -p .workflow/versions/$VERSION_ID/design
|
||||
mkdir -p .workflow/versions/$VERSION_ID/contexts
|
||||
mkdir -p .workflow/versions/$VERSION_ID/tasks
|
||||
```
|
||||
|
||||
#### 1.3: Display Design Start Banner
|
||||
```
|
||||
╔══════════════════════════════════════════════════════════════╗
|
||||
║ 📐 SYSTEM DESIGN PHASE ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ Feature: $ARGUMENTS ║
|
||||
║ Version: $VERSION_ID ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ You will define: ║
|
||||
║ Layer 1: Data Models (ER Diagram) ║
|
||||
║ Layer 2: API Endpoints (REST Contracts) ║
|
||||
║ Layer 3: Pages & Components (UI Structure) ║
|
||||
╚══════════════════════════════════════════════════════════════╝
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### ═══════════════════════════════════════════════════════════════
|
||||
### STEP 2: Analyze Requirements & Design System
|
||||
### ═══════════════════════════════════════════════════════════════
|
||||
|
||||
**Use Task tool with system-architect agent:**
|
||||
|
||||
```
|
||||
Use Task tool with:
|
||||
subagent_type: "system-architect"
|
||||
prompt: |
|
||||
# SYSTEM ARCHITECT - Design Document Creation
|
||||
|
||||
## INPUT
|
||||
Feature: "$ARGUMENTS"
|
||||
Version: $VERSION_ID
|
||||
Output: .workflow/versions/$VERSION_ID/design/design_document.yml
|
||||
|
||||
## YOUR MISSION
|
||||
Create a comprehensive design document following the schema in:
|
||||
skills/guardrail-orchestrator/schemas/design_document.yml
|
||||
|
||||
## ANALYSIS PROCESS
|
||||
|
||||
### Phase A: Understand Requirements
|
||||
1. Read the feature description carefully
|
||||
2. Identify the core user flows
|
||||
3. Determine what data needs to be stored
|
||||
4. Identify what APIs are needed
|
||||
5. Plan the UI structure
|
||||
|
||||
### Phase B: Design Data Layer (ER Diagram)
|
||||
For each entity needed:
|
||||
- Define fields with types and constraints
|
||||
- Define relations to other entities
|
||||
- Define validations
|
||||
- Consider indexes for performance
|
||||
|
||||
### Phase C: Design API Layer
|
||||
For each endpoint needed:
|
||||
- Define HTTP method and path
|
||||
- Define request body schema (for POST/PUT/PATCH)
|
||||
- Define response schemas for all status codes
|
||||
- Define authentication requirements
|
||||
- Link to data models used
|
||||
|
||||
### Phase D: Design UI Layer
|
||||
For each page needed:
|
||||
- Define route path
|
||||
- List data requirements (which APIs)
|
||||
- List components used
|
||||
- Define auth requirements
|
||||
|
||||
For each component needed:
|
||||
- Define props interface
|
||||
- Define events emitted
|
||||
- List child components
|
||||
- List APIs called directly (if any)
|
||||
|
||||
## OUTPUT FORMAT
|
||||
|
||||
Create `.workflow/versions/$VERSION_ID/design/design_document.yml`:
|
||||
|
||||
```yaml
|
||||
# Design Document
|
||||
workflow_version: "$VERSION_ID"
|
||||
feature: "$ARGUMENTS"
|
||||
created_at: <timestamp>
|
||||
status: draft
|
||||
revision: 1
|
||||
|
||||
# LAYER 1: DATA MODELS
|
||||
data_models:
|
||||
- id: model_<name>
|
||||
name: <PascalCase>
|
||||
description: "<what this model represents>"
|
||||
table_name: <snake_case>
|
||||
fields:
|
||||
- name: id
|
||||
type: uuid
|
||||
constraints: [primary_key]
|
||||
- name: <field_name>
|
||||
type: <string|integer|boolean|datetime|uuid|json|text|float|enum>
|
||||
constraints: [<unique|not_null|indexed|default>]
|
||||
# If enum:
|
||||
enum_values: [<value1>, <value2>]
|
||||
relations:
|
||||
- type: <has_one|has_many|belongs_to|many_to_many>
|
||||
target: model_<other>
|
||||
foreign_key: <fk_field>
|
||||
on_delete: <cascade|set_null|restrict>
|
||||
timestamps: true
|
||||
validations:
|
||||
- field: <field_name>
|
||||
rule: "<validation_rule>"
|
||||
message: "<error message>"
|
||||
|
||||
# LAYER 2: API ENDPOINTS
|
||||
api_endpoints:
|
||||
- id: api_<verb>_<resource>
|
||||
method: <GET|POST|PUT|PATCH|DELETE>
|
||||
path: /api/<path>
|
||||
summary: "<short description>"
|
||||
description: "<detailed description>"
|
||||
# For POST/PUT/PATCH:
|
||||
request_body:
|
||||
content_type: application/json
|
||||
schema:
|
||||
type: object
|
||||
properties:
|
||||
- name: <field>
|
||||
type: <type>
|
||||
required: <true|false>
|
||||
validations: [<rules>]
|
||||
responses:
|
||||
- status: 200
|
||||
description: "Success"
|
||||
schema:
|
||||
type: object
|
||||
properties:
|
||||
- name: <field>
|
||||
type: <type>
|
||||
- status: 400
|
||||
description: "Validation error"
|
||||
schema:
|
||||
type: object
|
||||
properties:
|
||||
- name: error
|
||||
type: string
|
||||
depends_on_models: [model_<name>]
|
||||
auth:
|
||||
required: <true|false>
|
||||
roles: [<role1>, <role2>]
|
||||
|
||||
# LAYER 3: PAGES
|
||||
pages:
|
||||
- id: page_<name>
|
||||
name: "<Human Name>"
|
||||
path: /<route>
|
||||
layout: <layout_component>
|
||||
data_needs:
|
||||
- api_id: api_<name>
|
||||
purpose: "<why needed>"
|
||||
on_load: <true|false>
|
||||
components: [component_<name1>, component_<name2>]
|
||||
auth:
|
||||
required: <true|false>
|
||||
roles: []
|
||||
redirect: /login
|
||||
|
||||
# LAYER 3: COMPONENTS
|
||||
components:
|
||||
- id: component_<name>
|
||||
name: <PascalCaseName>
|
||||
props:
|
||||
- name: <propName>
|
||||
type: <TypeScript type>
|
||||
required: <true|false>
|
||||
description: "<what this prop does>"
|
||||
events:
|
||||
- name: <onEventName>
|
||||
payload: "<payload type>"
|
||||
description: "<when this fires>"
|
||||
uses_apis: []
|
||||
uses_components: [component_<child>]
|
||||
variants: [<variant1>, <variant2>]
|
||||
```
|
||||
|
||||
## DESIGN PRINCIPLES
|
||||
|
||||
1. **Start with Data**: What data is needed? Design models first.
|
||||
2. **APIs Serve UI**: What operations does UI need? Design APIs next.
|
||||
3. **UI Consumes APIs**: Pages/Components use APIs. Design UI last.
|
||||
4. **Explicit Dependencies**: Every relation must be clearly defined.
|
||||
5. **Contracts First**: API request/response schemas are contracts.
|
||||
|
||||
## VERIFICATION
|
||||
|
||||
After creating the design document, verify:
|
||||
1. Every API references existing models
|
||||
2. Every page references existing APIs and components
|
||||
3. Every component references existing child components
|
||||
4. No circular dependencies
|
||||
|
||||
## OUTPUT
|
||||
|
||||
After creating the file, output:
|
||||
```
|
||||
=== DESIGN DOCUMENT CREATED ===
|
||||
|
||||
Data Models: X
|
||||
API Endpoints: X
|
||||
Pages: X
|
||||
Components: X
|
||||
|
||||
File: .workflow/versions/$VERSION_ID/design/design_document.yml
|
||||
```
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### ═══════════════════════════════════════════════════════════════
|
||||
### STEP 3: Validate Design & Generate Dependency Graph
|
||||
### ═══════════════════════════════════════════════════════════════
|
||||
|
||||
#### 3.1: Run Design Validation [MANDATORY]
|
||||
```bash
|
||||
python3 skills/guardrail-orchestrator/scripts/validate_design.py \
|
||||
.workflow/versions/$VERSION_ID/design/design_document.yml \
|
||||
--output-dir .workflow/versions/$VERSION_ID
|
||||
```
|
||||
|
||||
**This generates:**
|
||||
- `.workflow/versions/$VERSION_ID/dependency_graph.yml` - Layered execution order
|
||||
- `.workflow/versions/$VERSION_ID/contexts/*.yml` - Per-entity context snapshots
|
||||
- `.workflow/versions/$VERSION_ID/tasks/*.yml` - Tasks with full context
|
||||
|
||||
#### 3.2: Check Validation Result
|
||||
```bash
|
||||
VALIDATION_EXIT=$?
|
||||
if [ $VALIDATION_EXIT -ne 0 ]; then
|
||||
echo "❌ Design validation failed. Fix errors and re-run."
|
||||
exit 1
|
||||
fi
|
||||
```
|
||||
|
||||
**BLOCK IF**: Validation fails → Display errors, do not proceed
|
||||
|
||||
---
|
||||
|
||||
### ═══════════════════════════════════════════════════════════════
|
||||
### STEP 4: Display Layered Execution Plan
|
||||
### ═══════════════════════════════════════════════════════════════
|
||||
|
||||
Read the generated dependency graph and display:
|
||||
|
||||
```
|
||||
╔══════════════════════════════════════════════════════════════╗
|
||||
║ 📊 DEPENDENCY GRAPH - EXECUTION LAYERS ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ ║
|
||||
║ Layer 1: DATA MODELS (Parallel) ║
|
||||
║ ───────────────────────────────────────────── ║
|
||||
║ 📦 model_user → backend ║
|
||||
║ 📦 model_post → backend ║
|
||||
║ ║
|
||||
║ Layer 2: API ENDPOINTS (Parallel, after Layer 1) ║
|
||||
║ ───────────────────────────────────────────── ║
|
||||
║ 🔌 api_create_user → backend (needs: model_user) ║
|
||||
║ 🔌 api_list_users → backend (needs: model_user) ║
|
||||
║ 🔌 api_create_post → backend (needs: model_user, model_post)║
|
||||
║ ║
|
||||
║ Layer 3: UI (Parallel, after Layer 2) ║
|
||||
║ ───────────────────────────────────────────── ║
|
||||
║ 🧩 component_user_card → frontend ║
|
||||
║ 📄 page_users → frontend (needs: api_list_users) ║
|
||||
║ ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ EXECUTION SUMMARY ║
|
||||
║ Total entities: X ║
|
||||
║ Total layers: X ║
|
||||
║ Max parallelism: X (tasks can run simultaneously) ║
|
||||
║ Critical path: X layers deep ║
|
||||
╚══════════════════════════════════════════════════════════════╝
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### ═══════════════════════════════════════════════════════════════
|
||||
### STEP 5: Display Design Summary for Approval
|
||||
### ═══════════════════════════════════════════════════════════════
|
||||
|
||||
```
|
||||
╔══════════════════════════════════════════════════════════════╗
|
||||
║ 🛑 DESIGN APPROVAL REQUIRED ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ Feature: $ARGUMENTS ║
|
||||
║ Version: $VERSION_ID ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ DESIGN DOCUMENT ║
|
||||
║ 📦 Data Models: X ║
|
||||
║ 🔌 API Endpoints: X ║
|
||||
║ 📄 Pages: X ║
|
||||
║ 🧩 Components: X ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ GENERATED ARTIFACTS ║
|
||||
║ ✅ Dependency graph calculated ║
|
||||
║ ✅ Context snapshots created (X files) ║
|
||||
║ ✅ Implementation tasks created (X tasks) ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ EXECUTION PLAN ║
|
||||
║ Layer 1: X tasks (parallel) → backend ║
|
||||
║ Layer 2: X tasks (parallel) → backend ║
|
||||
║ Layer 3: X tasks (parallel) → frontend ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ FILES CREATED ║
|
||||
║ .workflow/versions/$VERSION_ID/design/design_document.yml ║
|
||||
║ .workflow/versions/$VERSION_ID/dependency_graph.yml ║
|
||||
║ .workflow/versions/$VERSION_ID/contexts/*.yml ║
|
||||
║ .workflow/versions/$VERSION_ID/tasks/*.yml ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ NEXT STEPS ║
|
||||
║ Review the design above, then: ║
|
||||
║ /workflow:approve - Proceed to implementation ║
|
||||
║ /workflow:reject - Request design changes ║
|
||||
╚══════════════════════════════════════════════════════════════╝
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### ═══════════════════════════════════════════════════════════════
|
||||
### STEP 6: Transition Workflow State
|
||||
### ═══════════════════════════════════════════════════════════════
|
||||
|
||||
```bash
|
||||
# Update progress
|
||||
TASK_COUNT=$(ls .workflow/versions/$VERSION_ID/tasks/*.yml 2>/dev/null | wc -l)
|
||||
python3 skills/guardrail-orchestrator/scripts/workflow_manager.py progress \
|
||||
--tasks-created $TASK_COUNT
|
||||
|
||||
# Transition to awaiting approval
|
||||
python3 skills/guardrail-orchestrator/scripts/workflow_manager.py transition AWAITING_DESIGN_APPROVAL
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## CONTEXT SNAPSHOT EXAMPLE
|
||||
|
||||
Each task gets a context file like `.workflow/versions/$VERSION_ID/contexts/api_create_user.yml`:
|
||||
|
||||
```yaml
|
||||
task_id: task_create_api_create_user
|
||||
entity_id: api_create_user
|
||||
workflow_version: v001
|
||||
|
||||
target:
|
||||
type: api
|
||||
definition:
|
||||
method: POST
|
||||
path: /api/users
|
||||
request_body:
|
||||
properties:
|
||||
- name: email
|
||||
type: string
|
||||
required: true
|
||||
validations: [email]
|
||||
- name: password
|
||||
type: string
|
||||
required: true
|
||||
validations: [min:8]
|
||||
responses:
|
||||
- status: 201
|
||||
schema: { id, email, name, created_at }
|
||||
- status: 400
|
||||
schema: { error, details }
|
||||
- status: 409
|
||||
schema: { error }
|
||||
|
||||
related:
|
||||
models:
|
||||
- id: model_user
|
||||
definition:
|
||||
name: User
|
||||
fields:
|
||||
- { name: id, type: uuid }
|
||||
- { name: email, type: string }
|
||||
- { name: password_hash, type: string }
|
||||
|
||||
dependencies:
|
||||
entity_ids: [model_user]
|
||||
|
||||
files:
|
||||
to_create:
|
||||
- app/api/users/route.ts
|
||||
reference:
|
||||
- path: app/api/health/route.ts
|
||||
purpose: "API route pattern"
|
||||
|
||||
acceptance:
|
||||
- criterion: "POST /api/users returns 201 on success"
|
||||
verification: "curl -X POST /api/users with valid data"
|
||||
- criterion: "Returns 409 if email exists"
|
||||
verification: "Test with duplicate email"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## USAGE
|
||||
|
||||
```bash
|
||||
# After /workflow:spawn, run design:
|
||||
/workflow:design
|
||||
|
||||
# This will:
|
||||
# 1. Create comprehensive design document
|
||||
# 2. Validate and generate dependency graph
|
||||
# 3. Create tasks with full context
|
||||
# 4. Wait for approval before implementation
|
||||
```
|
||||
|
|
@ -0,0 +1,193 @@
|
|||
---
|
||||
description: Compare workflow versions and show manifest changes
|
||||
allowed-tools: Read, Bash
|
||||
---
|
||||
|
||||
# Workflow Version Diff
|
||||
|
||||
Compare workflow versions to see what changed in the project manifest.
|
||||
|
||||
## EXECUTION PROTOCOL
|
||||
|
||||
### Step 1: Parse Arguments
|
||||
|
||||
```
|
||||
IF "$ARGUMENTS" = "":
|
||||
MODE = "current" (diff latest version with current)
|
||||
ELSE IF "$ARGUMENTS" matches "v\d+ v\d+":
|
||||
MODE = "versions" (diff two specific versions)
|
||||
ELSE IF "$ARGUMENTS" matches "v\d+":
|
||||
MODE = "single" (diff specific version with current)
|
||||
ELSE IF "$ARGUMENTS" = "--changelog" or "--log":
|
||||
MODE = "changelog" (show all version changelogs)
|
||||
ELSE IF "$ARGUMENTS" contains "--json":
|
||||
OUTPUT = "json"
|
||||
```
|
||||
|
||||
### Step 2: Get Available Versions
|
||||
|
||||
```bash
|
||||
python3 skills/guardrail-orchestrator/scripts/manifest_diff.py versions
|
||||
```
|
||||
|
||||
### Step 3: Execute Diff Based on Mode
|
||||
|
||||
**MODE: current (default)**
|
||||
```bash
|
||||
# Get latest version
|
||||
LATEST=$(ls -1 .workflow/versions/ 2>/dev/null | tail -1)
|
||||
|
||||
# Diff with current manifest
|
||||
python3 skills/guardrail-orchestrator/scripts/manifest_diff.py diff $LATEST current
|
||||
```
|
||||
|
||||
**MODE: versions (e.g., "v001 v002")**
|
||||
```bash
|
||||
# Diff two specific versions
|
||||
python3 skills/guardrail-orchestrator/scripts/manifest_diff.py diff v001 v002
|
||||
```
|
||||
|
||||
**MODE: single (e.g., "v001")**
|
||||
```bash
|
||||
# Diff specific version with current
|
||||
python3 skills/guardrail-orchestrator/scripts/manifest_diff.py diff v001
|
||||
```
|
||||
|
||||
**MODE: changelog**
|
||||
```bash
|
||||
# Show all changelogs
|
||||
python3 skills/guardrail-orchestrator/scripts/manifest_diff.py changelog
|
||||
```
|
||||
|
||||
**JSON output**
|
||||
```bash
|
||||
# Add --json for programmatic use
|
||||
python3 skills/guardrail-orchestrator/scripts/manifest_diff.py diff v001 --json
|
||||
```
|
||||
|
||||
### Step 4: Display Results
|
||||
|
||||
The script outputs:
|
||||
|
||||
```
|
||||
╔══════════════════════════════════════════════════════════════════════╗
|
||||
║ MANIFEST DIFF: v001 → v002 ║
|
||||
╠══════════════════════════════════════════════════════════════════════╣
|
||||
║ SUMMARY ║
|
||||
║ + Added: 3 ║
|
||||
║ ~ Modified: 2 ║
|
||||
║ - Removed: 1 ║
|
||||
║ = Unchanged: 5 ║
|
||||
╠══════════════════════════════════════════════════════════════════════╣
|
||||
║ BY TYPE ║
|
||||
║ pages: +1 ║
|
||||
║ components: +2 ~1 ║
|
||||
║ api_endpoints: ~1 -1 ║
|
||||
╠══════════════════════════════════════════════════════════════════════╣
|
||||
║ ➕ ADDED ║
|
||||
║ + 📄 Profile (app/profile/page.tsx) ║
|
||||
║ + 🧩 Button (app/components/Button.tsx) ║
|
||||
║ + 🧩 Modal (app/components/Modal.tsx) ║
|
||||
╠══════════════════════════════════════════════════════════════════════╣
|
||||
║ 📝 MODIFIED ║
|
||||
║ ~ 🧩 Header (app/components/Header.tsx) ║
|
||||
║ dependencies: [] → ['Button'] ║
|
||||
║ ~ 🔌 users (app/api/users/route.ts) ║
|
||||
║ status: PENDING → IMPLEMENTED ║
|
||||
╠══════════════════════════════════════════════════════════════════════╣
|
||||
║ ➖ REMOVED ║
|
||||
║ - 🔌 legacy (app/api/legacy/route.ts) ║
|
||||
╚══════════════════════════════════════════════════════════════════════╝
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## USAGE EXAMPLES
|
||||
|
||||
```bash
|
||||
# Compare latest version with current manifest
|
||||
/workflow:diff
|
||||
|
||||
# Compare two specific versions
|
||||
/workflow:diff v001 v002
|
||||
|
||||
# Compare specific version with current
|
||||
/workflow:diff v003
|
||||
|
||||
# Show all version changelogs
|
||||
/workflow:diff --changelog
|
||||
|
||||
# Output as JSON
|
||||
/workflow:diff v001 --json
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## WHAT IT SHOWS
|
||||
|
||||
### Entity Changes
|
||||
- **Added**: New pages, components, API endpoints, etc.
|
||||
- **Modified**: Status changes, dependency updates, path changes
|
||||
- **Removed**: Deleted entities from manifest
|
||||
|
||||
### Entity Type Icons
|
||||
- 📄 page
|
||||
- 🧩 component
|
||||
- 🔌 api_endpoint
|
||||
- 📚 lib
|
||||
- 🪝 hook
|
||||
- 📝 type
|
||||
- ⚙️ config
|
||||
|
||||
### Change Details
|
||||
- Entity name and file path
|
||||
- Specific field changes with before/after values
|
||||
- Summary statistics by type
|
||||
|
||||
---
|
||||
|
||||
## CHANGELOG MODE
|
||||
|
||||
Show version history with changes:
|
||||
|
||||
```bash
|
||||
/workflow:diff --changelog
|
||||
```
|
||||
|
||||
Output:
|
||||
```
|
||||
╔══════════════════════════════════════════════════════════════════════╗
|
||||
║ CHANGELOG: v001 ║
|
||||
╠══════════════════════════════════════════════════════════════════════╣
|
||||
║ Feature: User authentication ║
|
||||
║ Status: completed ║
|
||||
║ Started: 2025-01-15 10:30:00 ║
|
||||
║ Completed: 2025-01-15 14:45:00 ║
|
||||
╠══════════════════════════════════════════════════════════════════════╣
|
||||
║ CHANGES ║
|
||||
║ + Added page: Login ║
|
||||
║ + Added page: Register ║
|
||||
║ + Added component: AuthForm ║
|
||||
║ + Added api_endpoint: auth ║
|
||||
╚══════════════════════════════════════════════════════════════════════╝
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## INTEGRATION
|
||||
|
||||
### Uses Version Snapshots
|
||||
|
||||
The diff tool uses snapshots created by version_manager.py:
|
||||
- `snapshot_before/manifest.json` - Manifest at version start
|
||||
- `snapshot_after/manifest.json` - Manifest at version completion
|
||||
|
||||
These are automatically created when:
|
||||
- `/workflow:spawn` initializes a new version
|
||||
- `/workflow:complete` marks a version as done
|
||||
|
||||
### Related Commands
|
||||
|
||||
- `/workflow:history` - List all workflow versions
|
||||
- `/workflow:status` - Show current workflow state
|
||||
- `/workflow:changelog <version>` - Alias for `--changelog`
|
||||
|
|
@ -0,0 +1,85 @@
|
|||
---
|
||||
description: Implement frontend tasks (Frontend agent)
|
||||
allowed-tools: Read, Write, Edit, Bash
|
||||
---
|
||||
|
||||
# Frontend Agent - Implementation Mode
|
||||
|
||||
🎨 **FRONTEND AGENT ACTIVATED**
|
||||
|
||||
Implement task: "$ARGUMENTS"
|
||||
|
||||
## CRITICAL RULES
|
||||
|
||||
You are now the **FRONTEND AGENT**.
|
||||
|
||||
✅ **ALLOWED**:
|
||||
- Read any file
|
||||
- Write new files (components, pages)
|
||||
- Edit existing UI files
|
||||
- Run Bash (build, lint, type-check)
|
||||
|
||||
✅ **ALLOWED FILES**:
|
||||
- `app/components/**/*`
|
||||
- `app/**/page.tsx`
|
||||
- `app/**/layout.tsx`
|
||||
- `app/globals.css`
|
||||
|
||||
## Workflow
|
||||
|
||||
### Step 1: Load Task
|
||||
First, get the version-specific tasks directory:
|
||||
```bash
|
||||
TASKS_DIR=$(python3 skills/guardrail-orchestrator/scripts/version_manager.py tasks-dir)
|
||||
```
|
||||
|
||||
Read the task file: `$TASKS_DIR/$ARGUMENTS.yml`
|
||||
- If "$ARGUMENTS" is `--next`: find first task with `agent: frontend` and `status: pending`
|
||||
|
||||
### Step 2: Update Workflow State
|
||||
```bash
|
||||
python3 skills/guardrail-orchestrator/scripts/workflow_manager.py task <task_id> in_progress
|
||||
```
|
||||
|
||||
### Step 3: Verify Prerequisites
|
||||
- Check entity is `APPROVED` in `project_manifest.json`
|
||||
- Check all `dependencies` tasks are `completed`
|
||||
- If blocked:
|
||||
```bash
|
||||
python3 skills/guardrail-orchestrator/scripts/workflow_manager.py task <task_id> blocked
|
||||
```
|
||||
Stop and report blocker.
|
||||
|
||||
### Step 4: Implement
|
||||
For each file in `file_paths`:
|
||||
1. Read manifest entity specification
|
||||
2. Generate code matching spec exactly:
|
||||
- Props must match manifest
|
||||
- Types must match manifest
|
||||
- File path must match manifest
|
||||
3. Follow existing project patterns
|
||||
|
||||
### Step 5: Validate
|
||||
Run validations:
|
||||
```bash
|
||||
npm run lint
|
||||
npm run build
|
||||
```
|
||||
|
||||
### Step 6: Update Task Status
|
||||
Update the task file:
|
||||
```yaml
|
||||
status: review
|
||||
completed_at: <current timestamp>
|
||||
```
|
||||
|
||||
Update workflow state:
|
||||
```bash
|
||||
python3 skills/guardrail-orchestrator/scripts/workflow_manager.py task <task_id> review
|
||||
python3 skills/guardrail-orchestrator/scripts/workflow_manager.py progress --tasks-impl <count>
|
||||
```
|
||||
|
||||
### Step 7: Report
|
||||
- List implemented files
|
||||
- Show validation results
|
||||
- Suggest: `/workflow:review $ARGUMENTS`
|
||||
|
|
@ -0,0 +1,94 @@
|
|||
---
|
||||
description: Show workflow version history
|
||||
allowed-tools: Read, Bash
|
||||
---
|
||||
|
||||
# Workflow History
|
||||
|
||||
Display version history of all workflow sessions.
|
||||
|
||||
## Usage
|
||||
```
|
||||
/workflow:history # List all versions
|
||||
/workflow:history v001 # Show details for specific version
|
||||
/workflow:history --changelog # Show changelog for current version
|
||||
```
|
||||
|
||||
## Steps
|
||||
|
||||
### 1. List All Versions (default)
|
||||
```bash
|
||||
python3 skills/guardrail-orchestrator/scripts/version_manager.py history
|
||||
```
|
||||
|
||||
### 2. Show Version Details
|
||||
If "$ARGUMENTS" is a version (e.g., `v001`):
|
||||
```bash
|
||||
python3 skills/guardrail-orchestrator/scripts/version_manager.py changelog $ARGUMENTS
|
||||
```
|
||||
|
||||
### 3. Display Format
|
||||
|
||||
**Version List**:
|
||||
```
|
||||
╔══════════════════════════════════════════════════════════════════════╗
|
||||
║ WORKFLOW VERSION HISTORY ║
|
||||
╠══════════════════════════════════════════════════════════════════════╣
|
||||
║ ✅ v003: Dashboard with analytics ║
|
||||
║ Started: 2025-01-16T16:00:00 | Tasks: 12 | Ops: 45 ║
|
||||
║ ────────────────────────────────────────────────────────────────── ║
|
||||
║ ✅ v002: Task filters and search ║
|
||||
║ Started: 2025-01-16T14:00:00 | Tasks: 8 | Ops: 28 ║
|
||||
║ ────────────────────────────────────────────────────────────────── ║
|
||||
║ ✅ v001: User authentication ║
|
||||
║ Started: 2025-01-16T10:00:00 | Tasks: 5 | Ops: 18 ║
|
||||
╚══════════════════════════════════════════════════════════════════════╝
|
||||
```
|
||||
|
||||
**Version Changelog**:
|
||||
```
|
||||
╔══════════════════════════════════════════════════════════════════════╗
|
||||
║ CHANGELOG: v001 ║
|
||||
╠══════════════════════════════════════════════════════════════════════╣
|
||||
║ Feature: User authentication ║
|
||||
║ Status: completed ║
|
||||
╠══════════════════════════════════════════════════════════════════════╣
|
||||
║ CREATED ║
|
||||
║ + [page] page_login ║
|
||||
║ app/login/page.tsx ║
|
||||
║ + [component] component_LoginForm ║
|
||||
║ app/components/LoginForm.tsx ║
|
||||
║ + [api] api_auth ║
|
||||
║ app/api/auth/route.ts ║
|
||||
║ UPDATED ║
|
||||
║ ~ [component] component_Header ║
|
||||
║ DELETED ║
|
||||
║ (none) ║
|
||||
╠══════════════════════════════════════════════════════════════════════╣
|
||||
║ SUMMARY ║
|
||||
║ Entities: +3 ~1 -0 ║
|
||||
║ Files: +4 ~2 -0 ║
|
||||
╚══════════════════════════════════════════════════════════════════════╝
|
||||
```
|
||||
|
||||
### 4. Show Task Sessions
|
||||
If `$ARGUMENTS` includes `--tasks`:
|
||||
List all task sessions for the version with their operations:
|
||||
|
||||
```
|
||||
Task Sessions for v001:
|
||||
─────────────────────────────────────────────────
|
||||
🎨 task_create_LoginPage (frontend)
|
||||
Status: completed | Duration: 5m 32s
|
||||
Operations:
|
||||
+ CREATE file: app/login/page.tsx
|
||||
~ UPDATE manifest: project_manifest.json
|
||||
Review: ✅ approved
|
||||
|
||||
⚙️ task_create_AuthAPI (backend)
|
||||
Status: completed | Duration: 8m 15s
|
||||
Operations:
|
||||
+ CREATE file: app/api/auth/route.ts
|
||||
+ CREATE file: app/lib/auth.ts
|
||||
Review: ✅ approved
|
||||
```
|
||||
|
|
@ -0,0 +1,113 @@
|
|||
---
|
||||
description: Reject a workflow gate and request changes
|
||||
allowed-tools: Read, Write, Bash
|
||||
---
|
||||
|
||||
# Reject Workflow Gate
|
||||
|
||||
Reject gate with reason: "$ARGUMENTS"
|
||||
|
||||
## Usage
|
||||
```
|
||||
/workflow:reject design "Need more API endpoints for authentication"
|
||||
/workflow:reject implementation "Login form missing validation"
|
||||
```
|
||||
|
||||
## Steps
|
||||
|
||||
### 1. Parse Arguments
|
||||
Extract:
|
||||
- `gate`: First word (design | implementation)
|
||||
- `reason`: Remaining text in quotes
|
||||
|
||||
If invalid format:
|
||||
```
|
||||
❌ Usage: /workflow:reject <gate> "reason"
|
||||
|
||||
Examples:
|
||||
/workflow:reject design "Need user profile page"
|
||||
/workflow:reject implementation "Missing error handling"
|
||||
```
|
||||
|
||||
### 2. Check Workflow State
|
||||
```bash
|
||||
python3 skills/guardrail-orchestrator/scripts/workflow_manager.py exists
|
||||
```
|
||||
|
||||
If no active workflow:
|
||||
```
|
||||
❌ No active workflow found.
|
||||
```
|
||||
|
||||
### 3. Verify Current Phase
|
||||
|
||||
**For design rejection**:
|
||||
- Current phase must be `AWAITING_DESIGN_APPROVAL`
|
||||
|
||||
**For implementation rejection**:
|
||||
- Current phase must be `AWAITING_IMPL_APPROVAL`
|
||||
|
||||
### 4. Execute Rejection
|
||||
|
||||
```bash
|
||||
python3 skills/guardrail-orchestrator/scripts/workflow_manager.py reject <gate> "<reason>"
|
||||
```
|
||||
|
||||
### 5. Transition to Revision Phase
|
||||
|
||||
**If design rejected**:
|
||||
```bash
|
||||
python3 skills/guardrail-orchestrator/scripts/workflow_manager.py transition DESIGN_REJECTED
|
||||
python3 skills/guardrail-orchestrator/scripts/workflow_manager.py transition DESIGNING
|
||||
```
|
||||
|
||||
**If implementation rejected**:
|
||||
```bash
|
||||
python3 skills/guardrail-orchestrator/scripts/workflow_manager.py transition IMPL_REJECTED
|
||||
python3 skills/guardrail-orchestrator/scripts/workflow_manager.py transition IMPLEMENTING
|
||||
```
|
||||
|
||||
### 6. Report
|
||||
|
||||
**Design Rejected**:
|
||||
```
|
||||
╔══════════════════════════════════════════════════════════════╗
|
||||
║ ❌ DESIGN REJECTED ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ Reason: <rejection_reason> ║
|
||||
║ ║
|
||||
║ The workflow has returned to the DESIGNING phase. ║
|
||||
║ Revision count: X ║
|
||||
║ ║
|
||||
║ Next steps: ║
|
||||
║ /workflow:design --revise Revise the design ║
|
||||
║ /workflow:resume Auto-revise and continue ║
|
||||
╚══════════════════════════════════════════════════════════════╝
|
||||
```
|
||||
|
||||
**Implementation Rejected**:
|
||||
```
|
||||
╔══════════════════════════════════════════════════════════════╗
|
||||
║ ❌ IMPLEMENTATION REJECTED ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ Reason: <rejection_reason> ║
|
||||
║ ║
|
||||
║ The workflow has returned to the IMPLEMENTING phase. ║
|
||||
║ Revision count: X ║
|
||||
║ ║
|
||||
║ Tasks requiring fixes will be marked as 'pending'. ║
|
||||
║ ║
|
||||
║ Next steps: ║
|
||||
║ /workflow:frontend --next Fix frontend tasks ║
|
||||
║ /workflow:backend --next Fix backend tasks ║
|
||||
║ /workflow:resume Auto-fix and continue ║
|
||||
╚══════════════════════════════════════════════════════════════╝
|
||||
```
|
||||
|
||||
### 7. Update Related Tasks (Implementation Rejection)
|
||||
|
||||
If implementation was rejected, identify tasks related to the rejection reason and mark them as pending:
|
||||
|
||||
```bash
|
||||
python3 skills/guardrail-orchestrator/scripts/workflow_manager.py task <affected_task_id> pending
|
||||
```
|
||||
|
|
@ -0,0 +1,159 @@
|
|||
---
|
||||
description: Resume an interrupted workflow from saved state
|
||||
allowed-tools: Read, Write, Edit, Bash, AskUserQuestion, TodoWrite
|
||||
---
|
||||
|
||||
# Workflow Orchestrator - Resume
|
||||
|
||||
Resume a previously interrupted or paused workflow.
|
||||
|
||||
## EXECUTION PROTOCOL
|
||||
|
||||
### Step 1: Load Workflow State
|
||||
|
||||
Read `.workflow/current.yml`:
|
||||
- If not found: Report "No workflow to resume" and exit
|
||||
- If found: Load state and continue
|
||||
|
||||
### Step 2: Display Resume Summary
|
||||
|
||||
```
|
||||
╔══════════════════════════════════════════════════════════════╗
|
||||
║ 🔄 RESUMING WORKFLOW ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ Workflow ID: <id> ║
|
||||
║ Feature: <feature> ║
|
||||
║ Started: <started_at> ║
|
||||
║ Last Updated: <updated_at> ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ CURRENT STATE ║
|
||||
║ Phase: <current_phase> ║
|
||||
║ Resume Point: <resume_point.action> ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ PROGRESS ║
|
||||
║ Entities Designed: <progress.entities_designed> ║
|
||||
║ Tasks Created: <progress.tasks_created> ║
|
||||
║ Tasks Implemented: <progress.tasks_implemented> ║
|
||||
║ Tasks Reviewed: <progress.tasks_reviewed> ║
|
||||
║ Tasks Completed: <progress.tasks_completed> ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ LAST ERROR (if any): <last_error> ║
|
||||
╚══════════════════════════════════════════════════════════════╝
|
||||
```
|
||||
|
||||
### Step 3: Confirm Resume
|
||||
|
||||
**Ask user**:
|
||||
- Option 1: "Continue - Resume from current point"
|
||||
- Option 2: "Restart Phase - Redo current phase from beginning"
|
||||
- Option 3: "Abort - Cancel workflow entirely"
|
||||
|
||||
### Step 4: Resume Based on Phase
|
||||
|
||||
**INITIALIZING**:
|
||||
→ Continue to DESIGNING phase
|
||||
|
||||
**DESIGNING**:
|
||||
→ Continue architect work
|
||||
→ Resume creating entities/tasks
|
||||
|
||||
**AWAITING_DESIGN_APPROVAL**:
|
||||
→ Present design summary again
|
||||
→ Ask for approval
|
||||
|
||||
**DESIGN_APPROVED**:
|
||||
→ Continue to IMPLEMENTING phase
|
||||
|
||||
**DESIGN_REJECTED**:
|
||||
→ Show rejection reason
|
||||
→ Return to DESIGNING with feedback
|
||||
|
||||
**IMPLEMENTING**:
|
||||
→ Find incomplete tasks
|
||||
→ Continue implementation from next pending task
|
||||
|
||||
**REVIEWING**:
|
||||
→ Find tasks awaiting review
|
||||
→ Continue review process
|
||||
|
||||
**SECURITY_REVIEW**:
|
||||
→ Continue security scanning
|
||||
→ Run: `python3 skills/guardrail-orchestrator/scripts/security_scan.py --project-dir . --severity HIGH`
|
||||
→ Run: `python3 skills/guardrail-orchestrator/scripts/validate_api_contract.py --project-dir .`
|
||||
→ If passed: Transition to AWAITING_IMPL_APPROVAL
|
||||
→ If critical issues: Return to IMPLEMENTING with security feedback
|
||||
|
||||
**AWAITING_IMPL_APPROVAL**:
|
||||
→ Present implementation summary again
|
||||
→ Ask for approval
|
||||
|
||||
**IMPL_APPROVED**:
|
||||
→ Continue to COMPLETING phase
|
||||
|
||||
**IMPL_REJECTED**:
|
||||
→ Show rejection reason
|
||||
→ Return to IMPLEMENTING with feedback
|
||||
|
||||
**COMPLETING**:
|
||||
→ Continue marking tasks complete
|
||||
|
||||
**PAUSED**:
|
||||
→ Resume from `resume_point.phase`
|
||||
|
||||
**FAILED**:
|
||||
→ Show error details
|
||||
→ Ask user how to proceed:
|
||||
- Retry failed operation
|
||||
- Skip and continue
|
||||
- Abort workflow
|
||||
|
||||
### Step 5: Continue Workflow
|
||||
|
||||
Execute remaining phases following `/workflow:spawn` protocol.
|
||||
|
||||
## TASK-LEVEL RESUME
|
||||
|
||||
If resuming during IMPLEMENTING phase:
|
||||
|
||||
1. **Identify incomplete tasks**:
|
||||
```yaml
|
||||
# Resume from first task not in 'completed' or 'approved'
|
||||
resume_task: tasks.pending[0] || tasks.in_progress[0] || tasks.review[0]
|
||||
```
|
||||
|
||||
2. **Skip completed work**:
|
||||
- Don't recreate files that exist and are valid
|
||||
- Don't re-run validations that passed
|
||||
|
||||
3. **Continue from failure point**:
|
||||
- If task failed mid-implementation, restart that task
|
||||
- If validation failed, show error and retry
|
||||
|
||||
## STATE RECOVERY
|
||||
|
||||
If `.workflow/current.yml` is corrupted:
|
||||
|
||||
1. **Check for backup**: `.workflow/current.yml.bak`
|
||||
2. **Attempt recovery from manifest**:
|
||||
- Read `project_manifest.json` for entity status
|
||||
- Scan version-specific tasks directory for task status
|
||||
- Reconstruct workflow state
|
||||
3. **If unrecoverable**:
|
||||
- Report error
|
||||
- Suggest starting fresh with `/workflow:spawn`
|
||||
|
||||
## ABORT WORKFLOW
|
||||
|
||||
If user chooses to abort:
|
||||
|
||||
1. **Confirm abort**:
|
||||
"This will cancel the workflow. Files already created will remain. Continue?"
|
||||
|
||||
2. **If confirmed**:
|
||||
- Archive state to `.workflow/history/<id>_aborted.yml`
|
||||
- Clear `.workflow/current.yml`
|
||||
- Report: "Workflow aborted. Created files remain in place."
|
||||
|
||||
3. **Cleanup options**:
|
||||
- Offer to rollback created files (if git available)
|
||||
- Offer to keep partial implementation
|
||||
|
|
@ -0,0 +1,526 @@
|
|||
---
|
||||
description: Review implementation (Reviewer agent)
|
||||
allowed-tools: Read, Bash
|
||||
---
|
||||
|
||||
# Reviewer Agent - Review Mode
|
||||
|
||||
**Input**: "$ARGUMENTS"
|
||||
|
||||
---
|
||||
|
||||
## CRITICAL ENFORCEMENT RULES
|
||||
|
||||
**YOU ARE IN READ-ONLY MODE. VIOLATIONS WILL BE BLOCKED.**
|
||||
|
||||
### MUST DO (Non-Negotiable)
|
||||
1. **MUST** run all validation checks (build, typecheck, lint, test, API contract)
|
||||
2. **MUST** verify every file in task's `file_paths` exists
|
||||
3. **MUST** read and analyze each implemented file
|
||||
4. **MUST** check against acceptance_criteria in task file
|
||||
5. **MUST** output structured review report (format below)
|
||||
6. **MUST** run workflow_manager.py to update task status
|
||||
|
||||
### CANNOT DO (Strictly Forbidden)
|
||||
1. **CANNOT** create files (Write tool blocked)
|
||||
2. **CANNOT** modify files (Edit tool blocked)
|
||||
3. **CANNOT** fix issues yourself - only report them
|
||||
4. **CANNOT** approve tasks with missing files
|
||||
5. **CANNOT** approve if ANY validation check fails
|
||||
6. **CANNOT** skip any validation check
|
||||
|
||||
### ALLOWED ACTIONS
|
||||
- Read any file
|
||||
- Run Bash commands (build, lint, test, typecheck, ls, cat, grep)
|
||||
- Output review reports
|
||||
- Update task status via workflow_manager.py
|
||||
|
||||
---
|
||||
|
||||
## VALIDATION CHECKS MATRIX
|
||||
|
||||
| Check | Command | Blocks Approval | When |
|
||||
|-------|---------|-----------------|------|
|
||||
| Build | `npm run build` | YES | Always |
|
||||
| TypeScript | `npx tsc --noEmit` | YES | Always |
|
||||
| Async/Await | `python3 verify_async.py` | YES | Always |
|
||||
| Lint | `npm run lint` | YES (if --strict) | --strict mode |
|
||||
| Unit Tests | `npm test -- --passWithNoTests` | YES (if --strict) | --strict mode |
|
||||
| API Contract | `python3 validate_api_contract.py` | YES | Always |
|
||||
| Security Scan | `python3 security_scan.py` | YES (critical) | Always |
|
||||
| Files Exist | `ls -la` each file | YES | Always |
|
||||
|
||||
**Note:** For comprehensive security audit, use `/workflow:security --full`
|
||||
|
||||
---
|
||||
|
||||
## ARGUMENT PARSING
|
||||
|
||||
```
|
||||
IF "$ARGUMENTS" contains "--auto":
|
||||
MODE = AUTO (batch review all tasks)
|
||||
STRICT = "$ARGUMENTS" contains "--strict"
|
||||
FULL = "$ARGUMENTS" contains "--full"
|
||||
ELSE IF "$ARGUMENTS" = "--next":
|
||||
MODE = SINGLE (next pending task)
|
||||
ELSE:
|
||||
MODE = SINGLE (specific task: "$ARGUMENTS")
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## MODE: AUTO REVIEW (--auto)
|
||||
|
||||
### Step A1: Get Active Version [MANDATORY]
|
||||
```bash
|
||||
VERSION_ID=$(python3 skills/guardrail-orchestrator/scripts/version_manager.py current)
|
||||
TASKS_DIR=".workflow/versions/$VERSION_ID/tasks"
|
||||
```
|
||||
|
||||
### Step A2: Run Global Validations [MANDATORY]
|
||||
|
||||
#### 2.1 Build Check
|
||||
```bash
|
||||
npm run build 2>&1
|
||||
BUILD_EXIT=$?
|
||||
echo "BUILD_EXIT=$BUILD_EXIT"
|
||||
```
|
||||
|
||||
#### 2.2 TypeScript Strict Check
|
||||
```bash
|
||||
npx tsc --noEmit 2>&1
|
||||
TS_EXIT=$?
|
||||
echo "TS_EXIT=$TS_EXIT"
|
||||
```
|
||||
|
||||
#### 2.3 Async/Await Check [MANDATORY]
|
||||
```bash
|
||||
python3 skills/guardrail-orchestrator/scripts/verify_async.py --path . 2>&1
|
||||
ASYNC_EXIT=$?
|
||||
echo "ASYNC_EXIT=$ASYNC_EXIT"
|
||||
```
|
||||
|
||||
This catches runtime errors at build time:
|
||||
- `fetch()` without `await`
|
||||
- `.json()` without `await`
|
||||
- `Promise.all()` without `await`
|
||||
- Floating promises (unawaited async calls)
|
||||
|
||||
**Exit codes:**
|
||||
- 0 = PASS (no high-severity issues)
|
||||
- 1 = HIGH severity issues found (blocks approval)
|
||||
|
||||
#### 2.4 Lint Check (if --strict or --full)
|
||||
```bash
|
||||
npm run lint 2>&1
|
||||
LINT_EXIT=$?
|
||||
echo "LINT_EXIT=$LINT_EXIT"
|
||||
```
|
||||
|
||||
#### 2.5 Unit Tests (if --strict or --full)
|
||||
```bash
|
||||
npm test -- --passWithNoTests 2>&1
|
||||
TEST_EXIT=$?
|
||||
echo "TEST_EXIT=$TEST_EXIT"
|
||||
```
|
||||
|
||||
#### 2.6 API Contract Validation [MANDATORY]
|
||||
```bash
|
||||
python3 skills/guardrail-orchestrator/scripts/validate_api_contract.py --project-dir . 2>&1
|
||||
API_EXIT=$?
|
||||
echo "API_EXIT=$API_EXIT"
|
||||
```
|
||||
|
||||
This validates:
|
||||
- Frontend API calls have matching backend endpoints
|
||||
- HTTP methods match (GET, POST, PUT, DELETE)
|
||||
- Request bodies are sent where expected
|
||||
- Response handling matches backend output
|
||||
|
||||
#### 2.7 Security Scan [MANDATORY]
|
||||
```bash
|
||||
# Run comprehensive security scanner
|
||||
python3 skills/guardrail-orchestrator/scripts/security_scan.py \
|
||||
--project-dir . \
|
||||
--severity HIGH
|
||||
SECURITY_EXIT=$?
|
||||
echo "SECURITY_EXIT=$SECURITY_EXIT"
|
||||
```
|
||||
|
||||
**Security scan checks:**
|
||||
- Hardcoded secrets (API keys, passwords, tokens)
|
||||
- SQL injection vulnerabilities
|
||||
- XSS risks (dangerouslySetInnerHTML, innerHTML)
|
||||
- Command injection patterns
|
||||
- Path traversal vulnerabilities
|
||||
- NoSQL injection risks
|
||||
- SSRF vulnerabilities
|
||||
- Prototype pollution
|
||||
- Insecure authentication patterns
|
||||
- CORS misconfigurations
|
||||
- Sensitive data exposure
|
||||
- Debug code in production
|
||||
|
||||
**Exit codes:**
|
||||
- 0 = PASS (no critical/high issues)
|
||||
- 1 = HIGH issues found (warning)
|
||||
- 2 = CRITICAL issues found (blocks approval)
|
||||
|
||||
**For full security audit, run:** `/workflow:security --full`
|
||||
|
||||
### Step A3: Gather All Tasks [MANDATORY]
|
||||
```bash
|
||||
ls $TASKS_DIR/*.yml 2>/dev/null
|
||||
```
|
||||
**MUST process ALL task files found**
|
||||
|
||||
### Step A4: Review Each Task [MANDATORY]
|
||||
|
||||
For EACH task file:
|
||||
|
||||
```bash
|
||||
# Extract file_paths from task
|
||||
TASK_FILES=$(grep -A 20 "file_paths:" "$TASK_FILE" | grep -E "^\s+-" | sed 's/.*- //')
|
||||
```
|
||||
|
||||
**Check each file exists**:
|
||||
```bash
|
||||
for file in $TASK_FILES; do
|
||||
if [ -f "$file" ]; then
|
||||
echo "EXISTS: $file"
|
||||
else
|
||||
echo "MISSING: $file"
|
||||
MISSING_COUNT=$((MISSING_COUNT + 1))
|
||||
fi
|
||||
done
|
||||
```
|
||||
|
||||
**Determine task verdict**:
|
||||
```
|
||||
IF all files exist
|
||||
AND BUILD_EXIT = 0
|
||||
AND TS_EXIT = 0
|
||||
AND ASYNC_EXIT = 0
|
||||
AND API_EXIT = 0
|
||||
AND SECURITY_EXIT != 2 (no critical security issues)
|
||||
AND (not --strict OR (LINT_EXIT = 0 AND TEST_EXIT = 0)):
|
||||
-> TASK_VERDICT = APPROVED
|
||||
ELSE:
|
||||
-> TASK_VERDICT = REJECTED
|
||||
-> Record reason (missing files / build failure / type error / async issue / API mismatch / security issue)
|
||||
```
|
||||
|
||||
**Security exit codes:**
|
||||
- 0 = PASS
|
||||
- 1 = HIGH issues (warning, doesn't block unless --strict)
|
||||
- 2 = CRITICAL issues (always blocks)
|
||||
|
||||
### Step A5: Batch Update [MANDATORY]
|
||||
|
||||
For APPROVED tasks:
|
||||
```bash
|
||||
python3 skills/guardrail-orchestrator/scripts/workflow_manager.py task <task_id> approved
|
||||
```
|
||||
|
||||
For REJECTED tasks:
|
||||
```bash
|
||||
python3 skills/guardrail-orchestrator/scripts/workflow_manager.py task <task_id> pending
|
||||
```
|
||||
|
||||
### Step A6: Auto Review Report [MANDATORY]
|
||||
|
||||
**MUST output this exact format**:
|
||||
```
|
||||
+======================================================================+
|
||||
| REVIEW COMPLETE |
|
||||
+======================================================================+
|
||||
| Version: $VERSION_ID |
|
||||
| Mode: AUTO [STRICT if --strict] [FULL if --full] |
|
||||
+======================================================================+
|
||||
| VALIDATION RESULTS |
|
||||
+----------------------------------------------------------------------+
|
||||
| Build: PASS (exit 0) / FAIL (exit $BUILD_EXIT) |
|
||||
| TypeScript: PASS (exit 0) / FAIL (exit $TS_EXIT) |
|
||||
| Async/Await: PASS / FAIL (X high, Y medium issues) |
|
||||
| Lint: PASS / FAIL / SKIPPED |
|
||||
| Tests: PASS / FAIL / SKIPPED |
|
||||
| API Contract: PASS / FAIL (X errors, Y warnings) |
|
||||
| Security: PASS / WARNING / CRITICAL |
|
||||
| (C:X H:X M:X L:X issues) |
|
||||
+======================================================================+
|
||||
| API CONTRACT DETAILS |
|
||||
+----------------------------------------------------------------------+
|
||||
| Frontend calls: X matched, Y unmatched |
|
||||
| Backend endpoints: X defined, Y unused |
|
||||
| Method mismatches: X |
|
||||
| Body mismatches: X |
|
||||
+======================================================================+
|
||||
| TASK RESULTS |
|
||||
+----------------------------------------------------------------------+
|
||||
| Total: X tasks |
|
||||
| Approved: X tasks |
|
||||
| Rejected: X tasks |
|
||||
| Skipped: X tasks (already completed) |
|
||||
+======================================================================+
|
||||
| APPROVED TASKS |
|
||||
| - task_create_Button |
|
||||
| - task_create_Form |
|
||||
+----------------------------------------------------------------------+
|
||||
| REJECTED TASKS |
|
||||
| - task_create_Modal |
|
||||
| Reason: Missing file app/components/Modal.tsx |
|
||||
| - task_update_API |
|
||||
| Reason: API contract error - endpoint not found |
|
||||
+======================================================================+
|
||||
| SECURITY WARNINGS |
|
||||
| - src/lib/api.ts:15 - Possible hardcoded API key |
|
||||
| - app/page.tsx:42 - dangerouslySetInnerHTML usage |
|
||||
+======================================================================+
|
||||
```
|
||||
|
||||
### Step A7: Next Steps [MANDATORY]
|
||||
|
||||
**IF all approved**:
|
||||
```
|
||||
All tasks approved.
|
||||
Next: Run `/workflow:approve implementation` to continue.
|
||||
```
|
||||
|
||||
**IF any rejected**:
|
||||
```
|
||||
Some tasks need fixes.
|
||||
|
||||
API Contract Issues:
|
||||
For frontend issues: Fix the API call URL or method
|
||||
For backend issues: Create or fix the API endpoint
|
||||
|
||||
For each rejected task, run:
|
||||
/workflow:frontend <task_id> (for frontend tasks)
|
||||
/workflow:backend <task_id> (for backend tasks)
|
||||
|
||||
Then re-run: /workflow:review --auto
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## MODE: SINGLE TASK REVIEW (--next or task_id)
|
||||
|
||||
### Step S1: Get Task [MANDATORY]
|
||||
```bash
|
||||
VERSION_ID=$(python3 skills/guardrail-orchestrator/scripts/version_manager.py current)
|
||||
TASKS_DIR=".workflow/versions/$VERSION_ID/tasks"
|
||||
```
|
||||
|
||||
**IF --next**:
|
||||
```bash
|
||||
# Find first task with status: pending or status: implemented
|
||||
TASK_FILE=$(grep -l "status: pending\|status: implemented" $TASKS_DIR/*.yml 2>/dev/null | head -1)
|
||||
```
|
||||
|
||||
**IF specific task_id**:
|
||||
```bash
|
||||
TASK_FILE="$TASKS_DIR/$ARGUMENTS.yml"
|
||||
```
|
||||
|
||||
**BLOCK IF**: Task file does not exist -> Error: "Task not found: $ARGUMENTS"
|
||||
|
||||
### Step S2: Read Task Spec [MANDATORY]
|
||||
```bash
|
||||
cat "$TASK_FILE"
|
||||
```
|
||||
|
||||
Extract:
|
||||
- `id`: Task identifier
|
||||
- `file_paths`: List of files to verify
|
||||
- `acceptance_criteria`: List of requirements to check
|
||||
|
||||
### Step S3: Run All Validations [MANDATORY]
|
||||
|
||||
```bash
|
||||
# Build
|
||||
npm run build 2>&1
|
||||
BUILD_EXIT=$?
|
||||
|
||||
# TypeScript
|
||||
npx tsc --noEmit 2>&1
|
||||
TS_EXIT=$?
|
||||
|
||||
# API Contract
|
||||
python3 skills/guardrail-orchestrator/scripts/validate_api_contract.py --project-dir . 2>&1
|
||||
API_EXIT=$?
|
||||
```
|
||||
|
||||
**MUST capture and report all exit codes**
|
||||
|
||||
### Step S4: Verify Files Exist [MANDATORY]
|
||||
|
||||
For each path in `file_paths`:
|
||||
```bash
|
||||
ls -la "$path" 2>/dev/null && echo "EXISTS" || echo "MISSING"
|
||||
```
|
||||
|
||||
**Record**:
|
||||
- FILES_EXIST = true/false
|
||||
- MISSING_FILES = list of missing paths
|
||||
|
||||
### Step S5: Read and Analyze Files [MANDATORY]
|
||||
|
||||
For each EXISTING file:
|
||||
1. Read file content
|
||||
2. Check against acceptance_criteria:
|
||||
- [ ] File exports correct components/functions
|
||||
- [ ] Props/types match manifest spec
|
||||
- [ ] Code follows project patterns
|
||||
- [ ] No obvious bugs or issues
|
||||
3. Check API contract compliance:
|
||||
- [ ] Frontend calls use correct endpoints
|
||||
- [ ] HTTP methods are appropriate
|
||||
- [ ] Request bodies are properly structured
|
||||
- [ ] Response handling is correct
|
||||
|
||||
### Step S6: Determine Verdict [MANDATORY]
|
||||
|
||||
```
|
||||
IF BUILD_EXIT = 0
|
||||
AND TS_EXIT = 0
|
||||
AND API_EXIT = 0
|
||||
AND FILES_EXIST = true
|
||||
AND acceptance_criteria met:
|
||||
-> VERDICT = APPROVED
|
||||
ELSE:
|
||||
-> VERDICT = REQUEST_CHANGES
|
||||
-> Record all issues found
|
||||
```
|
||||
|
||||
### Step S7: Update Task Status [MANDATORY]
|
||||
|
||||
**IF APPROVED**:
|
||||
```bash
|
||||
python3 skills/guardrail-orchestrator/scripts/workflow_manager.py task $TASK_ID approved
|
||||
```
|
||||
|
||||
**IF REQUEST_CHANGES**:
|
||||
```bash
|
||||
python3 skills/guardrail-orchestrator/scripts/workflow_manager.py task $TASK_ID pending
|
||||
```
|
||||
|
||||
### Step S8: Output Review Report [MANDATORY]
|
||||
|
||||
**MUST output this exact format**:
|
||||
```
|
||||
+======================================================================+
|
||||
| TASK REVIEW |
|
||||
+======================================================================+
|
||||
| Task: $TASK_ID |
|
||||
| Version: $VERSION_ID |
|
||||
+======================================================================+
|
||||
| VALIDATION CHECKS |
|
||||
+----------------------------------------------------------------------+
|
||||
| Build: PASS / FAIL |
|
||||
| TypeScript: PASS / FAIL |
|
||||
| API Contract: PASS / FAIL |
|
||||
| Files exist: PASS / FAIL (X/Y files) |
|
||||
| Acceptance criteria: PASS / PARTIAL / FAIL |
|
||||
| Code quality: PASS / ISSUES |
|
||||
+======================================================================+
|
||||
| API CONTRACT STATUS |
|
||||
+----------------------------------------------------------------------+
|
||||
| Endpoint calls: X found, Y matched |
|
||||
| Method correctness: PASS / X mismatches |
|
||||
| Request bodies: PASS / X issues |
|
||||
| Response handling: PASS / ISSUES |
|
||||
+======================================================================+
|
||||
| VERDICT: APPROVED / REQUEST_CHANGES |
|
||||
+======================================================================+
|
||||
| [If REQUEST_CHANGES, list all issues:] |
|
||||
| 1. Missing file: app/components/Button.tsx |
|
||||
| 2. TypeScript error: Type 'string' not assignable to 'number' |
|
||||
| 3. API contract: POST /api/users called but endpoint expects GET |
|
||||
| 4. API contract: Frontend sends body but backend ignores it |
|
||||
| 5. Acceptance criterion not met: "Must support dark mode" |
|
||||
+======================================================================+
|
||||
```
|
||||
|
||||
### Step S9: Next Steps [MANDATORY]
|
||||
|
||||
**IF APPROVED**:
|
||||
```
|
||||
Task approved.
|
||||
Next: Run `/workflow:complete $TASK_ID` to mark as done.
|
||||
Or run `/workflow:review --next` to review next task.
|
||||
```
|
||||
|
||||
**IF REQUEST_CHANGES**:
|
||||
```
|
||||
Changes requested.
|
||||
|
||||
Issues to fix:
|
||||
[List specific issues with file locations]
|
||||
|
||||
For API contract issues:
|
||||
- If frontend issue: Fix the fetch/axios call in [file:line]
|
||||
- If backend issue: Update the API route handler in [file]
|
||||
|
||||
Fix issues and re-run:
|
||||
/workflow:frontend $TASK_ID (for frontend tasks)
|
||||
/workflow:backend $TASK_ID (for backend tasks)
|
||||
Then: /workflow:review $TASK_ID
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## USAGE EXAMPLES
|
||||
|
||||
```bash
|
||||
# Review specific task
|
||||
/workflow:review task_create_Button
|
||||
|
||||
# Review next pending task
|
||||
/workflow:review --next
|
||||
|
||||
# Auto-review all tasks (standard - build + types + API)
|
||||
/workflow:review --auto
|
||||
|
||||
# Auto-review all tasks (strict - includes lint + tests)
|
||||
/workflow:review --auto --strict
|
||||
|
||||
# Full review with all checks
|
||||
/workflow:review --auto --full
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## API CONTRACT VALIDATION DETAILS
|
||||
|
||||
The API contract validator checks:
|
||||
|
||||
### Frontend Analysis
|
||||
- **fetch()** calls with `/api/` paths
|
||||
- **axios** requests (get, post, put, delete)
|
||||
- **useSWR** data fetching hooks
|
||||
- **Custom API clients** (api.get, api.post, etc.)
|
||||
|
||||
### Backend Analysis
|
||||
- **Next.js App Router**: `app/api/*/route.ts` exports (GET, POST, PUT, DELETE)
|
||||
- **Next.js Pages Router**: `pages/api/*.ts` with req.method checks
|
||||
- **Express-style**: router.get/post/etc patterns
|
||||
|
||||
### Validation Rules
|
||||
1. **Endpoint Existence**: Every frontend call must have a matching backend route
|
||||
2. **Method Match**: GET calls must hit GET endpoints, POST to POST, etc.
|
||||
3. **Body Alignment**: POST/PUT calls should send bodies, GET should not
|
||||
4. **Unused Endpoints**: Backend routes not called by frontend (warnings)
|
||||
|
||||
---
|
||||
|
||||
## ENFORCEMENT CHECKLIST
|
||||
|
||||
Before completing this command, verify:
|
||||
- [ ] Build command executed and exit code captured
|
||||
- [ ] TypeScript check executed and exit code captured
|
||||
- [ ] API contract validation executed and exit code captured
|
||||
- [ ] All file_paths verified with ls command
|
||||
- [ ] Security scan completed
|
||||
- [ ] Structured review report output (exact format above)
|
||||
- [ ] Task status updated via workflow_manager.py
|
||||
- [ ] Next steps clearly stated
|
||||
|
|
@ -0,0 +1,342 @@
|
|||
---
|
||||
description: Run comprehensive security audit (Security Reviewer agent)
|
||||
allowed-tools: Read, Bash, Grep, Task
|
||||
---
|
||||
|
||||
# Security Reviewer Agent - Security Audit Mode
|
||||
|
||||
**Input**: "$ARGUMENTS"
|
||||
|
||||
---
|
||||
|
||||
## CRITICAL CONSTRAINTS
|
||||
|
||||
**YOU ARE IN READ-ONLY MODE FOR ANALYSIS.**
|
||||
|
||||
### MUST DO (Non-Negotiable)
|
||||
1. **MUST** run automated security scanner
|
||||
2. **MUST** analyze all CRITICAL and HIGH findings
|
||||
3. **MUST** check dependency vulnerabilities
|
||||
4. **MUST** review security configurations
|
||||
5. **MUST** output structured security report
|
||||
6. **MUST** provide remediation guidance
|
||||
|
||||
### CANNOT DO (Strictly Forbidden)
|
||||
1. **CANNOT** modify source files
|
||||
2. **CANNOT** fix issues directly
|
||||
3. **CANNOT** approve with CRITICAL issues
|
||||
4. **CANNOT** skip any security category
|
||||
|
||||
---
|
||||
|
||||
## ARGUMENT PARSING
|
||||
|
||||
```
|
||||
IF "$ARGUMENTS" contains "--quick":
|
||||
MODE = QUICK (scanner only)
|
||||
ELSE IF "$ARGUMENTS" contains "--full":
|
||||
MODE = FULL (scanner + deep analysis + deps + config)
|
||||
ELSE:
|
||||
MODE = STANDARD (scanner + deps)
|
||||
|
||||
SEVERITY = extract from --severity [critical|high|medium|low]
|
||||
OUTPUT = extract from --json (JSON output) or text
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## EXECUTION FLOW
|
||||
|
||||
### Step 1: Run Automated Security Scanner [MANDATORY]
|
||||
|
||||
```bash
|
||||
python3 skills/guardrail-orchestrator/scripts/security_scan.py \
|
||||
--project-dir . \
|
||||
--severity ${SEVERITY:-LOW} \
|
||||
${OUTPUT:+--json}
|
||||
```
|
||||
|
||||
**Capture output and exit code:**
|
||||
```bash
|
||||
SCAN_EXIT=$?
|
||||
echo "SCAN_EXIT=$SCAN_EXIT"
|
||||
```
|
||||
|
||||
**Exit codes:**
|
||||
- 0 = PASS (no critical/high issues)
|
||||
- 1 = HIGH issues found
|
||||
- 2 = CRITICAL issues found
|
||||
|
||||
### Step 2: Dependency Audit [MANDATORY unless --quick]
|
||||
|
||||
```bash
|
||||
echo "=== Dependency Audit ==="
|
||||
npm audit --json 2>/dev/null || echo '{"vulnerabilities":{}}'
|
||||
```
|
||||
|
||||
**Parse npm audit results:**
|
||||
- Count critical, high, moderate, low vulnerabilities
|
||||
- List affected packages and versions
|
||||
- Note if fixes available (`npm audit fix`)
|
||||
|
||||
### Step 3: Deep Analysis [FULL mode only]
|
||||
|
||||
For each CRITICAL/HIGH finding from scanner:
|
||||
|
||||
#### 3.1 Data Flow Tracing
|
||||
Use Task agent with security-engineer subagent:
|
||||
```
|
||||
Analyze data flow for vulnerability at [file:line].
|
||||
Trace user input from source to sink.
|
||||
Identify all potential attack vectors.
|
||||
Assess exploitability and impact.
|
||||
```
|
||||
|
||||
#### 3.2 Attack Vector Analysis
|
||||
For each vulnerability type:
|
||||
- SQL Injection → Check if input reaches query without sanitization
|
||||
- XSS → Check if input reaches DOM without encoding
|
||||
- Command Injection → Check if input reaches shell without escaping
|
||||
- Path Traversal → Check if input reaches file system without validation
|
||||
|
||||
### Step 4: Configuration Review [FULL mode only]
|
||||
|
||||
#### 4.1 CORS Configuration
|
||||
```bash
|
||||
grep -rn "cors\|Access-Control" app/ src/ pages/ --include="*.ts" --include="*.tsx" --include="*.js"
|
||||
```
|
||||
|
||||
Check for:
|
||||
- Wildcard origins (`*`)
|
||||
- Credentials with permissive origins
|
||||
- Missing CORS on sensitive endpoints
|
||||
|
||||
#### 4.2 Security Headers
|
||||
```bash
|
||||
grep -rn "helmet\|Content-Security-Policy\|X-Frame-Options\|X-XSS-Protection" . --include="*.ts" --include="*.js"
|
||||
```
|
||||
|
||||
Check for:
|
||||
- Helmet middleware usage
|
||||
- CSP configuration
|
||||
- X-Frame-Options
|
||||
- X-Content-Type-Options
|
||||
|
||||
#### 4.3 Authentication Configuration
|
||||
```bash
|
||||
grep -rn "jwt\|session\|auth\|cookie" app/ src/ pages/ --include="*.ts" --include="*.tsx"
|
||||
```
|
||||
|
||||
Check for:
|
||||
- JWT algorithm (avoid 'none', prefer RS256)
|
||||
- Session configuration
|
||||
- Cookie flags (httpOnly, secure, sameSite)
|
||||
|
||||
#### 4.4 Environment Variables
|
||||
```bash
|
||||
# Check .env files are gitignored
|
||||
cat .gitignore 2>/dev/null | grep -E "\.env"
|
||||
|
||||
# Check for env var usage
|
||||
grep -rn "process\.env\." app/ src/ --include="*.ts" --include="*.tsx" | head -20
|
||||
```
|
||||
|
||||
### Step 5: Manual Review Checklist [FULL mode only]
|
||||
|
||||
Read each file modified in current workflow and verify:
|
||||
|
||||
**Input Validation**
|
||||
- [ ] All user inputs validated
|
||||
- [ ] Type checking enforced
|
||||
- [ ] Length limits applied
|
||||
- [ ] Format validation (email, URL, etc.)
|
||||
|
||||
**Output Encoding**
|
||||
- [ ] HTML encoding for DOM insertion
|
||||
- [ ] URL encoding for URLs
|
||||
- [ ] JSON encoding for API responses
|
||||
|
||||
**Database Security**
|
||||
- [ ] Parameterized queries used
|
||||
- [ ] No string concatenation in queries
|
||||
- [ ] Proper ORM usage
|
||||
|
||||
**Authentication/Authorization**
|
||||
- [ ] Auth checks on protected routes
|
||||
- [ ] Role-based access control
|
||||
- [ ] Session validation
|
||||
|
||||
**Error Handling**
|
||||
- [ ] Generic error messages to users
|
||||
- [ ] No stack traces in production
|
||||
- [ ] No sensitive data in logs
|
||||
|
||||
### Step 6: Generate Security Report [MANDATORY]
|
||||
|
||||
**MUST output this exact format:**
|
||||
|
||||
```
|
||||
+======================================================================+
|
||||
| SECURITY AUDIT REPORT |
|
||||
+======================================================================+
|
||||
| Mode: QUICK / STANDARD / FULL |
|
||||
| Date: [current date] |
|
||||
| Project: [project name from package.json] |
|
||||
+======================================================================+
|
||||
| RISK ASSESSMENT |
|
||||
+----------------------------------------------------------------------+
|
||||
| Overall Risk: CRITICAL / HIGH / MEDIUM / LOW / PASS |
|
||||
| |
|
||||
| Static Analysis: X issues (C:X H:X M:X L:X) |
|
||||
| Dependencies: X vulnerabilities |
|
||||
| Configuration: X concerns |
|
||||
+======================================================================+
|
||||
| CRITICAL ISSUES (Immediate Action Required) |
|
||||
+----------------------------------------------------------------------+
|
||||
| [1] [CATEGORY] Title |
|
||||
| Location: file:line |
|
||||
| CWE: CWE-XXX |
|
||||
| OWASP: A0X:2021-Category |
|
||||
| Evidence: [code snippet] |
|
||||
| Impact: [description of potential attack] |
|
||||
| Fix: [specific remediation steps] |
|
||||
| |
|
||||
| [2] ... |
|
||||
+======================================================================+
|
||||
| HIGH ISSUES (Fix Before Production) |
|
||||
+----------------------------------------------------------------------+
|
||||
| [3] ... |
|
||||
+======================================================================+
|
||||
| MEDIUM ISSUES (Should Fix) |
|
||||
+----------------------------------------------------------------------+
|
||||
| [4] ... |
|
||||
+======================================================================+
|
||||
| DEPENDENCY VULNERABILITIES |
|
||||
+----------------------------------------------------------------------+
|
||||
| Package Version Severity Fix Available |
|
||||
| lodash 4.17.20 HIGH npm audit fix |
|
||||
| axios 0.21.0 MEDIUM npm audit fix |
|
||||
+======================================================================+
|
||||
| CONFIGURATION CONCERNS |
|
||||
+----------------------------------------------------------------------+
|
||||
| - CORS: Wildcard origin detected in src/middleware.ts |
|
||||
| - Session: Missing httpOnly flag on auth cookie |
|
||||
| - Headers: No CSP header configured |
|
||||
+======================================================================+
|
||||
| REMEDIATION PRIORITY |
|
||||
+----------------------------------------------------------------------+
|
||||
| 1. [CRITICAL] Rotate exposed API key in src/lib/api.ts |
|
||||
| 2. [CRITICAL] Fix SQL injection in app/api/users/route.ts |
|
||||
| 3. [HIGH] Update lodash to 4.17.21 |
|
||||
| 4. [HIGH] Add input validation to user registration |
|
||||
| 5. [MEDIUM] Configure CSP headers |
|
||||
+======================================================================+
|
||||
| VERDICT |
|
||||
+----------------------------------------------------------------------+
|
||||
| FAIL - X critical issues must be fixed before deployment |
|
||||
| or |
|
||||
| PASS - No blocking security issues found |
|
||||
+======================================================================+
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## VERDICT DETERMINATION
|
||||
|
||||
### FAIL Conditions
|
||||
- Any CRITICAL issue found
|
||||
- 3+ HIGH issues found
|
||||
- Critical npm vulnerabilities without fix
|
||||
- Exposed secrets or credentials
|
||||
|
||||
### PASS WITH WARNINGS
|
||||
- Only MEDIUM/LOW issues
|
||||
- All HIGH issues have accepted risk
|
||||
- Dependencies have fixes available
|
||||
|
||||
### PASS
|
||||
- No CRITICAL/HIGH issues
|
||||
- Dependencies up to date
|
||||
- Configurations reviewed
|
||||
|
||||
---
|
||||
|
||||
## POST-AUDIT ACTIONS
|
||||
|
||||
### If FAIL:
|
||||
```
|
||||
SECURITY AUDIT FAILED
|
||||
|
||||
Blocking issues must be fixed:
|
||||
1. [List critical issues]
|
||||
|
||||
For each issue:
|
||||
/workflow:frontend <task_id> - if frontend issue
|
||||
/workflow:backend <task_id> - if backend issue
|
||||
|
||||
Then re-run: /workflow:security
|
||||
```
|
||||
|
||||
### If PASS:
|
||||
```
|
||||
SECURITY AUDIT PASSED
|
||||
|
||||
Proceed with: /workflow:review --auto
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## USAGE EXAMPLES
|
||||
|
||||
```bash
|
||||
# Quick scan (automated scanner only)
|
||||
/workflow:security --quick
|
||||
|
||||
# Standard scan (scanner + dependencies)
|
||||
/workflow:security
|
||||
|
||||
# Full audit (all checks)
|
||||
/workflow:security --full
|
||||
|
||||
# Filter by severity
|
||||
/workflow:security --severity high
|
||||
|
||||
# JSON output for CI/CD
|
||||
/workflow:security --json
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## INTEGRATION WITH CI/CD
|
||||
|
||||
### Pre-commit Hook
|
||||
```bash
|
||||
python3 skills/guardrail-orchestrator/scripts/security_scan.py \
|
||||
--project-dir . --severity HIGH --strict
|
||||
```
|
||||
|
||||
### GitHub Actions
|
||||
```yaml
|
||||
- name: Security Scan
|
||||
run: |
|
||||
python3 skills/guardrail-orchestrator/scripts/security_scan.py \
|
||||
--project-dir . --json > security-report.json
|
||||
|
||||
if [ $? -ne 0 ]; then
|
||||
echo "Security issues found!"
|
||||
cat security-report.json
|
||||
exit 1
|
||||
fi
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ENFORCEMENT CHECKLIST
|
||||
|
||||
Before completing this command, verify:
|
||||
- [ ] Automated scanner executed
|
||||
- [ ] All categories analyzed
|
||||
- [ ] Dependencies audited (unless --quick)
|
||||
- [ ] Structured report output
|
||||
- [ ] Remediation guidance provided
|
||||
- [ ] Clear verdict stated
|
||||
File diff suppressed because it is too large
Load Diff
|
|
@ -0,0 +1,119 @@
|
|||
---
|
||||
description: Show workflow status and task summary
|
||||
allowed-tools: Read, Bash
|
||||
---
|
||||
|
||||
# Workflow Status
|
||||
|
||||
Display current workflow status and task breakdown.
|
||||
|
||||
## Steps
|
||||
|
||||
### 1. Check Active Workflow
|
||||
```bash
|
||||
python3 skills/guardrail-orchestrator/scripts/workflow_manager.py status
|
||||
```
|
||||
|
||||
If active workflow exists, display workflow state.
|
||||
If no workflow, continue with manual task scan.
|
||||
|
||||
### 2. Read Project Manifest
|
||||
Check `project_manifest.json` for:
|
||||
- Current phase
|
||||
- Entity counts by status
|
||||
|
||||
### 3. Scan Tasks
|
||||
Get the version-specific tasks directory:
|
||||
```bash
|
||||
TASKS_DIR=$(python3 skills/guardrail-orchestrator/scripts/version_manager.py tasks-dir)
|
||||
```
|
||||
|
||||
Read all `$TASKS_DIR/*.yml` files and count by:
|
||||
- Status (pending, in_progress, review, approved, completed, blocked)
|
||||
- Agent (frontend, backend, reviewer)
|
||||
- Type (create, update, delete, review)
|
||||
|
||||
### 4. Display Summary
|
||||
|
||||
```
|
||||
╔══════════════════════════════════════════════════════════════╗
|
||||
║ WORKFLOW STATUS ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ Active Workflow: <workflow_id> | None ║
|
||||
║ Feature: <feature_name> ║
|
||||
║ Phase: <current_phase> ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ APPROVAL GATES ║
|
||||
║ 🛑 Design: <pending|approved|rejected> ║
|
||||
║ 🛑 Implementation: <pending|approved|rejected> ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ TASKS BY STATUS ║
|
||||
║ ⏳ Pending: X ║
|
||||
║ 🔄 In Progress: X ║
|
||||
║ 🔍 Review: X ║
|
||||
║ ✅ Approved: X ║
|
||||
║ ✓ Completed: X ║
|
||||
║ 🚫 Blocked: X ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ TASKS BY AGENT ║
|
||||
║ 🎨 Frontend: X pending, X completed ║
|
||||
║ ⚙️ Backend: X pending, X completed ║
|
||||
║ 🔍 Reviewer: X pending ║
|
||||
╠══════════════════════════════════════════════════════════════╣
|
||||
║ NEXT ACTIONS ║
|
||||
║ /workflow:frontend --next (X tasks available) ║
|
||||
║ /workflow:backend --next (X tasks available) ║
|
||||
║ /workflow:review --next (X tasks to review) ║
|
||||
║ /workflow:resume (continue workflow) ║
|
||||
╚══════════════════════════════════════════════════════════════╝
|
||||
```
|
||||
|
||||
### 5. Show Design Visualization
|
||||
**If in DESIGNING or AWAITING_DESIGN_APPROVAL phase**, display visual design:
|
||||
|
||||
```bash
|
||||
python3 skills/guardrail-orchestrator/scripts/visualize_design.py --manifest project_manifest.json
|
||||
```
|
||||
|
||||
This shows:
|
||||
- 📱 Page flow diagram
|
||||
- 📄 Page details with components
|
||||
- 🧩 Component hierarchy
|
||||
- 🔌 API endpoints
|
||||
- 🔄 Data flow architecture
|
||||
|
||||
### 5b. Show Implementation Visualization
|
||||
**If in REVIEWING, SECURITY_REVIEW, or AWAITING_IMPL_APPROVAL phase**, display what was built:
|
||||
|
||||
```bash
|
||||
python3 skills/guardrail-orchestrator/scripts/visualize_implementation.py --manifest project_manifest.json
|
||||
```
|
||||
|
||||
This shows:
|
||||
- 📱 Page structure with routes
|
||||
- 🧩 Component hierarchy and relationships
|
||||
- 🔌 API endpoints with HTTP methods
|
||||
- 📊 Implementation statistics (lines, hooks, types)
|
||||
- 🌳 Component tree view
|
||||
|
||||
### 6. List Pending Tasks
|
||||
Show table of tasks ready to work on:
|
||||
|
||||
| Task ID | Type | Agent | Priority | Dependencies |
|
||||
|---------|------|-------|----------|--------------|
|
||||
|
||||
### 7. Show Approval Instructions
|
||||
|
||||
**If AWAITING_DESIGN_APPROVAL**:
|
||||
```
|
||||
🛑 Design approval required. Review the entities and tasks, then:
|
||||
- Approve: /workflow:approve design
|
||||
- Reject: /workflow:reject design "reason"
|
||||
```
|
||||
|
||||
**If AWAITING_IMPL_APPROVAL**:
|
||||
```
|
||||
🛑 Implementation approval required. Review the code, then:
|
||||
- Approve: /workflow:approve implementation
|
||||
- Reject: /workflow:reject implementation "reason"
|
||||
```
|
||||
|
|
@ -0,0 +1,4 @@
|
|||
api_key: pk_user_f5a39cbc686d4f4e0f9e815c035b69a314fd938adecb84bd3800dc6934d8f550
|
||||
project_id: ""
|
||||
repo_id: ""
|
||||
app_id: cmjabwyo00028ms0t8ju6mtkw
|
||||
|
|
@ -0,0 +1,225 @@
|
|||
{
|
||||
"hooks": {
|
||||
"PreToolUse": [
|
||||
{
|
||||
"matcher": "Bash",
|
||||
"hooks": [
|
||||
{
|
||||
"type": "command",
|
||||
"command": "python3 \"$CLAUDE_PROJECT_DIR/skills/guardrail-orchestrator/scripts/validate_bash.py\" --command \"$TOOL_INPUT_COMMAND\""
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"matcher": "Task",
|
||||
"hooks": [
|
||||
{
|
||||
"type": "command",
|
||||
"command": "python3 \"$CLAUDE_PROJECT_DIR/skills/guardrail-orchestrator/scripts/validate_workflow.py\" --operation task --input \"$TOOL_INPUT\""
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"matcher": "Write",
|
||||
"hooks": [
|
||||
{
|
||||
"type": "command",
|
||||
"command": "python3 \"$CLAUDE_PROJECT_DIR/skills/guardrail-orchestrator/scripts/validate_workflow.py\" --operation write --file \"$TOOL_INPUT_FILE_PATH\""
|
||||
},
|
||||
{
|
||||
"type": "command",
|
||||
"command": "python3 \"$CLAUDE_PROJECT_DIR/skills/guardrail-orchestrator/scripts/validate_write.py\" --manifest \"$CLAUDE_PROJECT_DIR/project_manifest.json\" --file \"$TOOL_INPUT_FILE_PATH\""
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"matcher": "Edit",
|
||||
"hooks": [
|
||||
{
|
||||
"type": "command",
|
||||
"command": "python3 \"$CLAUDE_PROJECT_DIR/skills/guardrail-orchestrator/scripts/validate_workflow.py\" --operation edit --file \"$TOOL_INPUT_FILE_PATH\""
|
||||
},
|
||||
{
|
||||
"type": "command",
|
||||
"command": "python3 \"$CLAUDE_PROJECT_DIR/skills/guardrail-orchestrator/scripts/validate_write.py\" --manifest \"$CLAUDE_PROJECT_DIR/project_manifest.json\" --file \"$TOOL_INPUT_FILE_PATH\""
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"matcher": "MultiEdit",
|
||||
"hooks": [
|
||||
{
|
||||
"type": "command",
|
||||
"command": "python3 \"$CLAUDE_PROJECT_DIR/skills/guardrail-orchestrator/scripts/validate_workflow.py\" --operation edit --file \"$TOOL_INPUT_FILE_PATH\""
|
||||
},
|
||||
{
|
||||
"type": "command",
|
||||
"command": "python3 \"$CLAUDE_PROJECT_DIR/skills/guardrail-orchestrator/scripts/validate_write.py\" --manifest \"$CLAUDE_PROJECT_DIR/project_manifest.json\" --file \"$TOOL_INPUT_FILE_PATH\""
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"matcher": "NotebookEdit",
|
||||
"hooks": [
|
||||
{
|
||||
"type": "command",
|
||||
"command": "python3 \"$CLAUDE_PROJECT_DIR/skills/guardrail-orchestrator/scripts/validate_workflow.py\" --operation edit --file \"$TOOL_INPUT_NOTEBOOK_PATH\""
|
||||
},
|
||||
{
|
||||
"type": "command",
|
||||
"command": "python3 \"$CLAUDE_PROJECT_DIR/skills/guardrail-orchestrator/scripts/validate_write.py\" --manifest \"$CLAUDE_PROJECT_DIR/project_manifest.json\" --file \"$TOOL_INPUT_NOTEBOOK_PATH\""
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"matcher": "mcp__serena__create_text_file",
|
||||
"hooks": [
|
||||
{
|
||||
"type": "command",
|
||||
"command": "python3 \"$CLAUDE_PROJECT_DIR/skills/guardrail-orchestrator/scripts/validate_workflow.py\" --operation write --input \"$TOOL_INPUT\""
|
||||
},
|
||||
{
|
||||
"type": "command",
|
||||
"command": "python3 \"$CLAUDE_PROJECT_DIR/skills/guardrail-orchestrator/scripts/validate_write.py\" --manifest \"$CLAUDE_PROJECT_DIR/project_manifest.json\" --file \"$TOOL_INPUT_FILE_PATH\""
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"matcher": "mcp__serena__replace_content",
|
||||
"hooks": [
|
||||
{
|
||||
"type": "command",
|
||||
"command": "python3 \"$CLAUDE_PROJECT_DIR/skills/guardrail-orchestrator/scripts/validate_workflow.py\" --operation edit --input \"$TOOL_INPUT\""
|
||||
},
|
||||
{
|
||||
"type": "command",
|
||||
"command": "python3 \"$CLAUDE_PROJECT_DIR/skills/guardrail-orchestrator/scripts/validate_write.py\" --manifest \"$CLAUDE_PROJECT_DIR/project_manifest.json\" --file \"$TOOL_INPUT_FILE_PATH\""
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"matcher": "mcp__serena__replace_symbol_body",
|
||||
"hooks": [
|
||||
{
|
||||
"type": "command",
|
||||
"command": "python3 \"$CLAUDE_PROJECT_DIR/skills/guardrail-orchestrator/scripts/validate_workflow.py\" --operation edit --input \"$TOOL_INPUT\""
|
||||
},
|
||||
{
|
||||
"type": "command",
|
||||
"command": "python3 \"$CLAUDE_PROJECT_DIR/skills/guardrail-orchestrator/scripts/validate_write.py\" --manifest \"$CLAUDE_PROJECT_DIR/project_manifest.json\" --file \"$TOOL_INPUT_FILE_PATH\""
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"matcher": "mcp__morphllm-fast-apply__write_file",
|
||||
"hooks": [
|
||||
{
|
||||
"type": "command",
|
||||
"command": "python3 \"$CLAUDE_PROJECT_DIR/skills/guardrail-orchestrator/scripts/validate_workflow.py\" --operation write --input \"$TOOL_INPUT\""
|
||||
},
|
||||
{
|
||||
"type": "command",
|
||||
"command": "python3 \"$CLAUDE_PROJECT_DIR/skills/guardrail-orchestrator/scripts/validate_write.py\" --manifest \"$CLAUDE_PROJECT_DIR/project_manifest.json\" --file \"$TOOL_INPUT_FILE_PATH\""
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"matcher": "mcp__morphllm-fast-apply__tiny_edit_file",
|
||||
"hooks": [
|
||||
{
|
||||
"type": "command",
|
||||
"command": "python3 \"$CLAUDE_PROJECT_DIR/skills/guardrail-orchestrator/scripts/validate_workflow.py\" --operation edit --input \"$TOOL_INPUT\""
|
||||
},
|
||||
{
|
||||
"type": "command",
|
||||
"command": "python3 \"$CLAUDE_PROJECT_DIR/skills/guardrail-orchestrator/scripts/validate_write.py\" --manifest \"$CLAUDE_PROJECT_DIR/project_manifest.json\" --file \"$TOOL_INPUT_FILE_PATH\""
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"matcher": "mcp__filesystem__write_file",
|
||||
"hooks": [
|
||||
{
|
||||
"type": "command",
|
||||
"command": "python3 \"$CLAUDE_PROJECT_DIR/skills/guardrail-orchestrator/scripts/validate_workflow.py\" --operation write --input \"$TOOL_INPUT\""
|
||||
},
|
||||
{
|
||||
"type": "command",
|
||||
"command": "python3 \"$CLAUDE_PROJECT_DIR/skills/guardrail-orchestrator/scripts/validate_write.py\" --manifest \"$CLAUDE_PROJECT_DIR/project_manifest.json\" --file \"$TOOL_INPUT_PATH\""
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"matcher": "mcp__filesystem__edit_file",
|
||||
"hooks": [
|
||||
{
|
||||
"type": "command",
|
||||
"command": "python3 \"$CLAUDE_PROJECT_DIR/skills/guardrail-orchestrator/scripts/validate_workflow.py\" --operation edit --input \"$TOOL_INPUT\""
|
||||
},
|
||||
{
|
||||
"type": "command",
|
||||
"command": "python3 \"$CLAUDE_PROJECT_DIR/skills/guardrail-orchestrator/scripts/validate_write.py\" --manifest \"$CLAUDE_PROJECT_DIR/project_manifest.json\" --file \"$TOOL_INPUT_PATH\""
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"matcher": "mcp__filesystem__create_directory",
|
||||
"hooks": [
|
||||
{
|
||||
"type": "command",
|
||||
"command": "python3 \"$CLAUDE_PROJECT_DIR/skills/guardrail-orchestrator/scripts/validate_workflow.py\" --operation write --input \"$TOOL_INPUT\""
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"matcher": "mcp__filesystem__move_file",
|
||||
"hooks": [
|
||||
{
|
||||
"type": "command",
|
||||
"command": "python3 \"$CLAUDE_PROJECT_DIR/skills/guardrail-orchestrator/scripts/validate_workflow.py\" --operation write --input \"$TOOL_INPUT\""
|
||||
}
|
||||
]
|
||||
}
|
||||
],
|
||||
"PostToolUse": [
|
||||
{
|
||||
"matcher": "Write",
|
||||
"hooks": [
|
||||
{
|
||||
"type": "command",
|
||||
"command": "python3 \"$CLAUDE_PROJECT_DIR/skills/guardrail-orchestrator/scripts/post_write.py\" --manifest \"$CLAUDE_PROJECT_DIR/project_manifest.json\" --file \"$TOOL_INPUT_FILE_PATH\""
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"matcher": "Edit",
|
||||
"hooks": [
|
||||
{
|
||||
"type": "command",
|
||||
"command": "python3 \"$CLAUDE_PROJECT_DIR/skills/guardrail-orchestrator/scripts/post_write.py\" --manifest \"$CLAUDE_PROJECT_DIR/project_manifest.json\" --file \"$TOOL_INPUT_FILE_PATH\""
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"matcher": "Task",
|
||||
"hooks": [
|
||||
{
|
||||
"type": "command",
|
||||
"command": "echo '🔄 Agent task completed. Verify outputs before proceeding.'"
|
||||
}
|
||||
]
|
||||
}
|
||||
],
|
||||
"Stop": [
|
||||
{
|
||||
"matcher": "",
|
||||
"hooks": [
|
||||
{
|
||||
"type": "command",
|
||||
"command": "python3 \"$CLAUDE_PROJECT_DIR/skills/guardrail-orchestrator/scripts/workflow_manager.py\" status 2>/dev/null || echo '🛡️ Session complete (no active workflow)'"
|
||||
}
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
|
|
@ -0,0 +1,145 @@
|
|||
# Context Compaction Skill
|
||||
|
||||
## Purpose
|
||||
Manages context window by saving state before compaction and resuming after.
|
||||
Ensures workflow continuity across context compressions.
|
||||
|
||||
## Activation Triggers
|
||||
- Manual: `/compact` command
|
||||
- Manual: `/save-state` command
|
||||
- Manual: `/resume` command
|
||||
- Auto: When context usage exceeds 80%
|
||||
|
||||
## Commands
|
||||
|
||||
### /compact - Full Compaction Workflow
|
||||
Saves state and prepares for context compaction:
|
||||
|
||||
```bash
|
||||
# 1. Save current workflow state
|
||||
python3 skills/guardrail-orchestrator/scripts/context_compact.py save \
|
||||
--workflow-dir .workflow/versions/v001 \
|
||||
--checkpoint
|
||||
|
||||
# 2. Display resume prompt for reference
|
||||
python3 skills/guardrail-orchestrator/scripts/context_compact.py resume \
|
||||
--workflow-dir .workflow/versions/v001
|
||||
```
|
||||
|
||||
### /save-state - Quick State Save
|
||||
Saves state without compaction:
|
||||
|
||||
```bash
|
||||
python3 skills/guardrail-orchestrator/scripts/context_compact.py save \
|
||||
--workflow-dir .workflow/versions/v001
|
||||
```
|
||||
|
||||
### /resume - Resume After Compaction
|
||||
After context is compacted, inject resume context:
|
||||
|
||||
```bash
|
||||
python3 skills/guardrail-orchestrator/scripts/context_compact.py resume \
|
||||
--workflow-dir .workflow/versions/v001
|
||||
```
|
||||
|
||||
### /context-status - Check State
|
||||
View current context state:
|
||||
|
||||
```bash
|
||||
python3 skills/guardrail-orchestrator/scripts/context_compact.py status \
|
||||
--workflow-dir .workflow/versions/v001
|
||||
```
|
||||
|
||||
## Auto-Detection Rules
|
||||
|
||||
When context feels heavy (many tool calls, large files read), check:
|
||||
1. Are we approaching context limit?
|
||||
2. Is there unsaved progress?
|
||||
3. Should we recommend compaction?
|
||||
|
||||
### Warning Thresholds
|
||||
- **70%**: Log warning, suggest saving state soon
|
||||
- **80%**: Auto-save state, continue working
|
||||
- **90%**: Strongly recommend compaction
|
||||
- **95%**: Force state save immediately
|
||||
|
||||
## State Files Generated
|
||||
|
||||
After `/compact` or `/save-state`:
|
||||
|
||||
```
|
||||
.workflow/versions/v001/
|
||||
├── context_state.json # Full serialized state
|
||||
├── resume_prompt.md # Human-readable resume
|
||||
└── modified_files.json # Recent file changes
|
||||
```
|
||||
|
||||
## Resume Workflow
|
||||
|
||||
After user runs `/compact` and context is cleared:
|
||||
|
||||
1. **User starts new session**
|
||||
2. **Run `/resume`** - Injects previous context
|
||||
3. **Claude reads state** - Understands where to continue
|
||||
4. **Continue work** - Pick up from next action
|
||||
|
||||
## State Contents
|
||||
|
||||
The context_state.json captures:
|
||||
|
||||
```json
|
||||
{
|
||||
"session_id": "compact_20250118_143022",
|
||||
"workflow_position": {
|
||||
"current_phase": "IMPLEMENTING",
|
||||
"active_task_id": "task_create_api_login",
|
||||
"layer": 2
|
||||
},
|
||||
"active_work": {
|
||||
"entity_id": "api_auth_login",
|
||||
"action": "implementing",
|
||||
"file_path": "app/api/auth/login/route.ts",
|
||||
"progress_notes": "Created route, need JWT generation"
|
||||
},
|
||||
"next_actions": [
|
||||
{"action": "implement", "target": "JWT token generation", "priority": 1}
|
||||
],
|
||||
"modified_files": [...],
|
||||
"decisions": [...],
|
||||
"blockers": [...]
|
||||
}
|
||||
```
|
||||
|
||||
## Integration with Workflow
|
||||
|
||||
This skill integrates with:
|
||||
- **workflow_state.yml** - Reads current phase and task status
|
||||
- **tasks/*.yml** - Identifies pending and in-progress tasks
|
||||
- **Git** - Tracks modified files, can create checkpoints
|
||||
|
||||
## Best Practices
|
||||
|
||||
1. **Save frequently** - Run `/save-state` after completing major steps
|
||||
2. **Before risky operations** - Save state before large refactors
|
||||
3. **End of session** - Always save state before ending work
|
||||
4. **After compaction** - Always run `/resume` to restore context
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### No state found on resume
|
||||
```bash
|
||||
python3 skills/guardrail-orchestrator/scripts/context_compact.py status \
|
||||
--workflow-dir .workflow/versions/v001
|
||||
```
|
||||
|
||||
### Clear stale state
|
||||
```bash
|
||||
python3 skills/guardrail-orchestrator/scripts/context_compact.py clear \
|
||||
--workflow-dir .workflow/versions/v001
|
||||
```
|
||||
|
||||
### Manual state inspection
|
||||
```bash
|
||||
cat .workflow/versions/v001/context_state.json | jq .
|
||||
cat .workflow/versions/v001/resume_prompt.md
|
||||
```
|
||||
|
|
@ -0,0 +1,6 @@
|
|||
{
|
||||
"taskId": "workflow-v001-earn-app",
|
||||
"title": "Implement Earn-to-Play App",
|
||||
"startedAt": "2025-12-18T01:40:00Z",
|
||||
"status": "in_progress"
|
||||
}
|
||||
|
|
@ -0,0 +1,16 @@
|
|||
{
|
||||
"mcpServers": {
|
||||
"eureka-docs": {
|
||||
"command": "npx",
|
||||
"args": ["eureka-docs-server"],
|
||||
"env": {}
|
||||
},
|
||||
"eureka-imagen": {
|
||||
"command": "npx",
|
||||
"args": ["eureka-imagen-server"],
|
||||
"env": {
|
||||
"IMAGEROUTER_API_KEY": "${IMAGEROUTER_API_KEY}"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
|
@ -0,0 +1,4 @@
|
|||
{
|
||||
"active_version": "v001",
|
||||
"session_id": "workflow_20251218_013734"
|
||||
}
|
||||
|
|
@ -0,0 +1,15 @@
|
|||
{
|
||||
"versions": [
|
||||
{
|
||||
"version": "v001",
|
||||
"feature": "a complete to earn app",
|
||||
"status": "pending",
|
||||
"started_at": "2025-12-18T01:37:34.999814",
|
||||
"completed_at": null,
|
||||
"tasks_count": 0,
|
||||
"operations_count": 0
|
||||
}
|
||||
],
|
||||
"latest_version": "v001",
|
||||
"total_versions": 1
|
||||
}
|
||||
|
|
@ -0,0 +1,103 @@
|
|||
{
|
||||
"session_id": "compact_20251218_021138",
|
||||
"captured_at": "2025-12-18T02:11:38.618766",
|
||||
"context_usage": {
|
||||
"tokens_used": 0,
|
||||
"tokens_max": 0,
|
||||
"percentage": 0.85,
|
||||
"threshold_triggered": 0.8
|
||||
},
|
||||
"workflow_position": {
|
||||
"workflow_id": "unknown",
|
||||
"current_phase": "UNKNOWN",
|
||||
"active_task_id": null,
|
||||
"layer": 1
|
||||
},
|
||||
"active_work": {
|
||||
"entity_id": "",
|
||||
"entity_type": "",
|
||||
"action": "pending",
|
||||
"file_path": null,
|
||||
"progress_notes": ""
|
||||
},
|
||||
"next_actions": [],
|
||||
"modified_files": [
|
||||
{
|
||||
"path": "pp/page.tsx",
|
||||
"action": "modified",
|
||||
"summary": ""
|
||||
},
|
||||
{
|
||||
"path": ".claude/",
|
||||
"action": "untracked",
|
||||
"summary": ""
|
||||
},
|
||||
{
|
||||
"path": ".eureka-active-session",
|
||||
"action": "untracked",
|
||||
"summary": ""
|
||||
},
|
||||
{
|
||||
"path": ".mcp.json",
|
||||
"action": "untracked",
|
||||
"summary": ""
|
||||
},
|
||||
{
|
||||
"path": ".workflow/",
|
||||
"action": "untracked",
|
||||
"summary": ""
|
||||
},
|
||||
{
|
||||
"path": "CLAUDE.md",
|
||||
"action": "untracked",
|
||||
"summary": ""
|
||||
},
|
||||
{
|
||||
"path": "app/api/",
|
||||
"action": "untracked",
|
||||
"summary": ""
|
||||
},
|
||||
{
|
||||
"path": "app/components/",
|
||||
"action": "untracked",
|
||||
"summary": ""
|
||||
},
|
||||
{
|
||||
"path": "app/lib/",
|
||||
"action": "untracked",
|
||||
"summary": ""
|
||||
},
|
||||
{
|
||||
"path": "app/login/",
|
||||
"action": "untracked",
|
||||
"summary": ""
|
||||
},
|
||||
{
|
||||
"path": "app/register/",
|
||||
"action": "untracked",
|
||||
"summary": ""
|
||||
},
|
||||
{
|
||||
"path": "app/tasks/",
|
||||
"action": "untracked",
|
||||
"summary": ""
|
||||
},
|
||||
{
|
||||
"path": "project_manifest.json",
|
||||
"action": "untracked",
|
||||
"summary": ""
|
||||
},
|
||||
{
|
||||
"path": "skills/",
|
||||
"action": "untracked",
|
||||
"summary": ""
|
||||
},
|
||||
{
|
||||
"path": "start-workflow.sh",
|
||||
"action": "untracked",
|
||||
"summary": ""
|
||||
}
|
||||
],
|
||||
"decisions": [],
|
||||
"blockers": []
|
||||
}
|
||||
|
|
@ -0,0 +1,71 @@
|
|||
{
|
||||
"task_id": "task_create_api_auth_login",
|
||||
"entity_id": "api_auth_login",
|
||||
"generated_at": "2025-12-18T01:57:52.722550",
|
||||
"workflow_version": "v001",
|
||||
"target": {
|
||||
"type": "api",
|
||||
"definition": {
|
||||
"id": "api_auth_login",
|
||||
"path": "/api/auth/login",
|
||||
"method": "POST",
|
||||
"description": "Login existing user",
|
||||
"file_path": "app/api/auth/login/route.ts",
|
||||
"status": "PENDING",
|
||||
"request_body": {
|
||||
"email": "string (required)",
|
||||
"password": "string (required)"
|
||||
},
|
||||
"responses": [
|
||||
{
|
||||
"status": 200,
|
||||
"description": "Success",
|
||||
"schema": {
|
||||
"user": {
|
||||
"id": "string",
|
||||
"email": "string",
|
||||
"name": "string"
|
||||
},
|
||||
"token": "string (JWT)"
|
||||
}
|
||||
},
|
||||
{
|
||||
"status": 401,
|
||||
"description": "Error",
|
||||
"schema": {
|
||||
"error": "Invalid credentials"
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
},
|
||||
"related": {
|
||||
"models": [],
|
||||
"apis": [],
|
||||
"components": []
|
||||
},
|
||||
"dependencies": {
|
||||
"entity_ids": [],
|
||||
"definitions": []
|
||||
},
|
||||
"files": {
|
||||
"to_create": [
|
||||
"app/api/auth/login/route.ts"
|
||||
],
|
||||
"reference": []
|
||||
},
|
||||
"acceptance": [
|
||||
{
|
||||
"criterion": "POST /api/auth/login returns success response",
|
||||
"verification": "curl -X POST /api/auth/login"
|
||||
},
|
||||
{
|
||||
"criterion": "Request validation implemented",
|
||||
"verification": "Test with invalid data"
|
||||
},
|
||||
{
|
||||
"criterion": "Error responses match contract",
|
||||
"verification": "Test error scenarios"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
|
@ -0,0 +1,66 @@
|
|||
{
|
||||
"task_id": "task_create_api_auth_me",
|
||||
"entity_id": "api_auth_me",
|
||||
"generated_at": "2025-12-18T01:57:52.722632",
|
||||
"workflow_version": "v001",
|
||||
"target": {
|
||||
"type": "api",
|
||||
"definition": {
|
||||
"id": "api_auth_me",
|
||||
"path": "/api/auth/me",
|
||||
"method": "GET",
|
||||
"description": "Get current authenticated user",
|
||||
"file_path": "app/api/auth/me/route.ts",
|
||||
"status": "PENDING",
|
||||
"auth_required": true,
|
||||
"responses": [
|
||||
{
|
||||
"status": 200,
|
||||
"description": "Success",
|
||||
"schema": {
|
||||
"id": "string",
|
||||
"email": "string",
|
||||
"name": "string",
|
||||
"created_at": "string (ISO date)"
|
||||
}
|
||||
},
|
||||
{
|
||||
"status": 401,
|
||||
"description": "Error",
|
||||
"schema": {
|
||||
"error": "Unauthorized"
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
},
|
||||
"related": {
|
||||
"models": [],
|
||||
"apis": [],
|
||||
"components": []
|
||||
},
|
||||
"dependencies": {
|
||||
"entity_ids": [],
|
||||
"definitions": []
|
||||
},
|
||||
"files": {
|
||||
"to_create": [
|
||||
"app/api/auth/me/route.ts"
|
||||
],
|
||||
"reference": []
|
||||
},
|
||||
"acceptance": [
|
||||
{
|
||||
"criterion": "GET /api/auth/me returns success response",
|
||||
"verification": "curl -X GET /api/auth/me"
|
||||
},
|
||||
{
|
||||
"criterion": "Request validation implemented",
|
||||
"verification": "Test with invalid data"
|
||||
},
|
||||
{
|
||||
"criterion": "Error responses match contract",
|
||||
"verification": "Test error scenarios"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
|
@ -0,0 +1,72 @@
|
|||
{
|
||||
"task_id": "task_create_api_auth_register",
|
||||
"entity_id": "api_auth_register",
|
||||
"generated_at": "2025-12-18T01:57:52.722465",
|
||||
"workflow_version": "v001",
|
||||
"target": {
|
||||
"type": "api",
|
||||
"definition": {
|
||||
"id": "api_auth_register",
|
||||
"path": "/api/auth/register",
|
||||
"method": "POST",
|
||||
"description": "Create new user account",
|
||||
"file_path": "app/api/auth/register/route.ts",
|
||||
"status": "PENDING",
|
||||
"request_body": {
|
||||
"email": "string (required)",
|
||||
"password": "string (required, min 8 chars)",
|
||||
"name": "string (required)"
|
||||
},
|
||||
"responses": [
|
||||
{
|
||||
"status": 201,
|
||||
"description": "Success",
|
||||
"schema": {
|
||||
"user": {
|
||||
"id": "string",
|
||||
"email": "string",
|
||||
"name": "string"
|
||||
},
|
||||
"token": "string (JWT)"
|
||||
}
|
||||
},
|
||||
{
|
||||
"status": 400,
|
||||
"description": "Error",
|
||||
"schema": {
|
||||
"error": "string (validation error or email exists)"
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
},
|
||||
"related": {
|
||||
"models": [],
|
||||
"apis": [],
|
||||
"components": []
|
||||
},
|
||||
"dependencies": {
|
||||
"entity_ids": [],
|
||||
"definitions": []
|
||||
},
|
||||
"files": {
|
||||
"to_create": [
|
||||
"app/api/auth/register/route.ts"
|
||||
],
|
||||
"reference": []
|
||||
},
|
||||
"acceptance": [
|
||||
{
|
||||
"criterion": "POST /api/auth/register returns success response",
|
||||
"verification": "curl -X POST /api/auth/register"
|
||||
},
|
||||
{
|
||||
"criterion": "Request validation implemented",
|
||||
"verification": "Test with invalid data"
|
||||
},
|
||||
{
|
||||
"criterion": "Error responses match contract",
|
||||
"verification": "Test error scenarios"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
|
@ -0,0 +1,67 @@
|
|||
{
|
||||
"task_id": "task_create_api_leaderboard",
|
||||
"entity_id": "api_leaderboard",
|
||||
"generated_at": "2025-12-18T01:57:52.723271",
|
||||
"workflow_version": "v001",
|
||||
"target": {
|
||||
"type": "api",
|
||||
"definition": {
|
||||
"id": "api_leaderboard",
|
||||
"path": "/api/leaderboard",
|
||||
"method": "GET",
|
||||
"description": "Get top users by points",
|
||||
"file_path": "app/api/leaderboard/route.ts",
|
||||
"status": "PENDING",
|
||||
"auth_required": true,
|
||||
"query_params": {
|
||||
"limit": "integer (optional, default 100)"
|
||||
},
|
||||
"responses": [
|
||||
{
|
||||
"status": 200,
|
||||
"description": "Success",
|
||||
"schema": {
|
||||
"leaderboard": [
|
||||
{
|
||||
"rank": "integer",
|
||||
"user_id": "string",
|
||||
"name": "string",
|
||||
"total_points": "integer"
|
||||
}
|
||||
],
|
||||
"current_user_rank": "integer"
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
},
|
||||
"related": {
|
||||
"models": [],
|
||||
"apis": [],
|
||||
"components": []
|
||||
},
|
||||
"dependencies": {
|
||||
"entity_ids": [],
|
||||
"definitions": []
|
||||
},
|
||||
"files": {
|
||||
"to_create": [
|
||||
"app/api/leaderboard/route.ts"
|
||||
],
|
||||
"reference": []
|
||||
},
|
||||
"acceptance": [
|
||||
{
|
||||
"criterion": "GET /api/leaderboard returns success response",
|
||||
"verification": "curl -X GET /api/leaderboard"
|
||||
},
|
||||
{
|
||||
"criterion": "Request validation implemented",
|
||||
"verification": "Test with invalid data"
|
||||
},
|
||||
{
|
||||
"criterion": "Error responses match contract",
|
||||
"verification": "Test error scenarios"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
|
@ -0,0 +1,64 @@
|
|||
{
|
||||
"task_id": "task_create_api_quizzes_get",
|
||||
"entity_id": "api_quizzes_get",
|
||||
"generated_at": "2025-12-18T01:57:52.723112",
|
||||
"workflow_version": "v001",
|
||||
"target": {
|
||||
"type": "api",
|
||||
"definition": {
|
||||
"id": "api_quizzes_get",
|
||||
"path": "/api/quizzes/:taskId",
|
||||
"method": "GET",
|
||||
"description": "Get quiz questions for a task",
|
||||
"file_path": "app/api/quizzes/[taskId]/route.ts",
|
||||
"status": "PENDING",
|
||||
"auth_required": true,
|
||||
"responses": [
|
||||
{
|
||||
"status": 200,
|
||||
"description": "Success",
|
||||
"schema": {
|
||||
"questions": [
|
||||
{
|
||||
"id": "string",
|
||||
"question": "string",
|
||||
"options": [
|
||||
"string"
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
},
|
||||
"related": {
|
||||
"models": [],
|
||||
"apis": [],
|
||||
"components": []
|
||||
},
|
||||
"dependencies": {
|
||||
"entity_ids": [],
|
||||
"definitions": []
|
||||
},
|
||||
"files": {
|
||||
"to_create": [
|
||||
"app/api/quizzes/taskId/route.ts"
|
||||
],
|
||||
"reference": []
|
||||
},
|
||||
"acceptance": [
|
||||
{
|
||||
"criterion": "GET /api/quizzes/:taskId returns success response",
|
||||
"verification": "curl -X GET /api/quizzes/:taskId"
|
||||
},
|
||||
{
|
||||
"criterion": "Request validation implemented",
|
||||
"verification": "Test with invalid data"
|
||||
},
|
||||
{
|
||||
"criterion": "Error responses match contract",
|
||||
"verification": "Test error scenarios"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
|
@ -0,0 +1,62 @@
|
|||
{
|
||||
"task_id": "task_create_api_quizzes_submit",
|
||||
"entity_id": "api_quizzes_submit",
|
||||
"generated_at": "2025-12-18T01:57:52.723196",
|
||||
"workflow_version": "v001",
|
||||
"target": {
|
||||
"type": "api",
|
||||
"definition": {
|
||||
"id": "api_quizzes_submit",
|
||||
"path": "/api/quizzes/:taskId/submit",
|
||||
"method": "POST",
|
||||
"description": "Submit quiz answers",
|
||||
"file_path": "app/api/quizzes/[taskId]/submit/route.ts",
|
||||
"status": "PENDING",
|
||||
"auth_required": true,
|
||||
"request_body": {
|
||||
"answers": "object (question_id -> answer mapping)"
|
||||
},
|
||||
"responses": [
|
||||
{
|
||||
"status": 200,
|
||||
"description": "Success",
|
||||
"schema": {
|
||||
"score": "integer (0-100)",
|
||||
"passed": "boolean",
|
||||
"points_earned": "integer",
|
||||
"new_balance": "integer"
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
},
|
||||
"related": {
|
||||
"models": [],
|
||||
"apis": [],
|
||||
"components": []
|
||||
},
|
||||
"dependencies": {
|
||||
"entity_ids": [],
|
||||
"definitions": []
|
||||
},
|
||||
"files": {
|
||||
"to_create": [
|
||||
"app/api/quizzes/taskId/submit/route.ts"
|
||||
],
|
||||
"reference": []
|
||||
},
|
||||
"acceptance": [
|
||||
{
|
||||
"criterion": "POST /api/quizzes/:taskId/submit returns success response",
|
||||
"verification": "curl -X POST /api/quizzes/:taskId/submit"
|
||||
},
|
||||
{
|
||||
"criterion": "Request validation implemented",
|
||||
"verification": "Test with invalid data"
|
||||
},
|
||||
{
|
||||
"criterion": "Error responses match contract",
|
||||
"verification": "Test error scenarios"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
|
@ -0,0 +1,67 @@
|
|||
{
|
||||
"task_id": "task_create_api_referrals_claim",
|
||||
"entity_id": "api_referrals_claim",
|
||||
"generated_at": "2025-12-18T01:57:52.723424",
|
||||
"workflow_version": "v001",
|
||||
"target": {
|
||||
"type": "api",
|
||||
"definition": {
|
||||
"id": "api_referrals_claim",
|
||||
"path": "/api/referrals/claim",
|
||||
"method": "POST",
|
||||
"description": "Claim referral bonus",
|
||||
"file_path": "app/api/referrals/claim/route.ts",
|
||||
"status": "PENDING",
|
||||
"auth_required": true,
|
||||
"request_body": {
|
||||
"referral_code": "string (required)"
|
||||
},
|
||||
"responses": [
|
||||
{
|
||||
"status": 200,
|
||||
"description": "Success",
|
||||
"schema": {
|
||||
"bonus_points": "integer",
|
||||
"new_balance": "integer"
|
||||
}
|
||||
},
|
||||
{
|
||||
"status": 400,
|
||||
"description": "Error",
|
||||
"schema": {
|
||||
"error": "string (invalid code or already used)"
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
},
|
||||
"related": {
|
||||
"models": [],
|
||||
"apis": [],
|
||||
"components": []
|
||||
},
|
||||
"dependencies": {
|
||||
"entity_ids": [],
|
||||
"definitions": []
|
||||
},
|
||||
"files": {
|
||||
"to_create": [
|
||||
"app/api/referrals/claim/route.ts"
|
||||
],
|
||||
"reference": []
|
||||
},
|
||||
"acceptance": [
|
||||
{
|
||||
"criterion": "POST /api/referrals/claim returns success response",
|
||||
"verification": "curl -X POST /api/referrals/claim"
|
||||
},
|
||||
{
|
||||
"criterion": "Request validation implemented",
|
||||
"verification": "Test with invalid data"
|
||||
},
|
||||
{
|
||||
"criterion": "Error responses match contract",
|
||||
"verification": "Test error scenarios"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
|
@ -0,0 +1,57 @@
|
|||
{
|
||||
"task_id": "task_create_api_referrals_create",
|
||||
"entity_id": "api_referrals_create",
|
||||
"generated_at": "2025-12-18T01:57:52.723352",
|
||||
"workflow_version": "v001",
|
||||
"target": {
|
||||
"type": "api",
|
||||
"definition": {
|
||||
"id": "api_referrals_create",
|
||||
"path": "/api/referrals",
|
||||
"method": "POST",
|
||||
"description": "Create referral code",
|
||||
"file_path": "app/api/referrals/route.ts",
|
||||
"status": "PENDING",
|
||||
"auth_required": true,
|
||||
"responses": [
|
||||
{
|
||||
"status": 200,
|
||||
"description": "Success",
|
||||
"schema": {
|
||||
"referral_code": "string",
|
||||
"referral_url": "string"
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
},
|
||||
"related": {
|
||||
"models": [],
|
||||
"apis": [],
|
||||
"components": []
|
||||
},
|
||||
"dependencies": {
|
||||
"entity_ids": [],
|
||||
"definitions": []
|
||||
},
|
||||
"files": {
|
||||
"to_create": [
|
||||
"app/api/referrals/route.ts"
|
||||
],
|
||||
"reference": []
|
||||
},
|
||||
"acceptance": [
|
||||
{
|
||||
"criterion": "POST /api/referrals returns success response",
|
||||
"verification": "curl -X POST /api/referrals"
|
||||
},
|
||||
{
|
||||
"criterion": "Request validation implemented",
|
||||
"verification": "Test with invalid data"
|
||||
},
|
||||
{
|
||||
"criterion": "Error responses match contract",
|
||||
"verification": "Test error scenarios"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
|
@ -0,0 +1,65 @@
|
|||
{
|
||||
"task_id": "task_create_api_tasks_checkin",
|
||||
"entity_id": "api_tasks_checkin",
|
||||
"generated_at": "2025-12-18T01:57:52.722948",
|
||||
"workflow_version": "v001",
|
||||
"target": {
|
||||
"type": "api",
|
||||
"definition": {
|
||||
"id": "api_tasks_checkin",
|
||||
"path": "/api/tasks/checkin",
|
||||
"method": "POST",
|
||||
"description": "Complete daily check-in",
|
||||
"file_path": "app/api/tasks/checkin/route.ts",
|
||||
"status": "PENDING",
|
||||
"auth_required": true,
|
||||
"responses": [
|
||||
{
|
||||
"status": 200,
|
||||
"description": "Success",
|
||||
"schema": {
|
||||
"points_earned": "integer",
|
||||
"streak_days": "integer",
|
||||
"new_balance": "integer"
|
||||
}
|
||||
},
|
||||
{
|
||||
"status": 400,
|
||||
"description": "Error",
|
||||
"schema": {
|
||||
"error": "Already checked in today"
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
},
|
||||
"related": {
|
||||
"models": [],
|
||||
"apis": [],
|
||||
"components": []
|
||||
},
|
||||
"dependencies": {
|
||||
"entity_ids": [],
|
||||
"definitions": []
|
||||
},
|
||||
"files": {
|
||||
"to_create": [
|
||||
"app/api/tasks/checkin/route.ts"
|
||||
],
|
||||
"reference": []
|
||||
},
|
||||
"acceptance": [
|
||||
{
|
||||
"criterion": "POST /api/tasks/checkin returns success response",
|
||||
"verification": "curl -X POST /api/tasks/checkin"
|
||||
},
|
||||
{
|
||||
"criterion": "Request validation implemented",
|
||||
"verification": "Test with invalid data"
|
||||
},
|
||||
{
|
||||
"criterion": "Error responses match contract",
|
||||
"verification": "Test error scenarios"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
|
@ -0,0 +1,64 @@
|
|||
{
|
||||
"task_id": "task_create_api_tasks_complete",
|
||||
"entity_id": "api_tasks_complete",
|
||||
"generated_at": "2025-12-18T01:57:52.723026",
|
||||
"workflow_version": "v001",
|
||||
"target": {
|
||||
"type": "api",
|
||||
"definition": {
|
||||
"id": "api_tasks_complete",
|
||||
"path": "/api/tasks/:id/complete",
|
||||
"method": "POST",
|
||||
"description": "Complete a specific task",
|
||||
"file_path": "app/api/tasks/[id]/complete/route.ts",
|
||||
"status": "PENDING",
|
||||
"auth_required": true,
|
||||
"responses": [
|
||||
{
|
||||
"status": 200,
|
||||
"description": "Success",
|
||||
"schema": {
|
||||
"points_earned": "integer",
|
||||
"new_balance": "integer"
|
||||
}
|
||||
},
|
||||
{
|
||||
"status": 400,
|
||||
"description": "Error",
|
||||
"schema": {
|
||||
"error": "string (task not found or already completed)"
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
},
|
||||
"related": {
|
||||
"models": [],
|
||||
"apis": [],
|
||||
"components": []
|
||||
},
|
||||
"dependencies": {
|
||||
"entity_ids": [],
|
||||
"definitions": []
|
||||
},
|
||||
"files": {
|
||||
"to_create": [
|
||||
"app/api/tasks/id/complete/route.ts"
|
||||
],
|
||||
"reference": []
|
||||
},
|
||||
"acceptance": [
|
||||
{
|
||||
"criterion": "POST /api/tasks/:id/complete returns success response",
|
||||
"verification": "curl -X POST /api/tasks/:id/complete"
|
||||
},
|
||||
{
|
||||
"criterion": "Request validation implemented",
|
||||
"verification": "Test with invalid data"
|
||||
},
|
||||
{
|
||||
"criterion": "Error responses match contract",
|
||||
"verification": "Test error scenarios"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
|
@ -0,0 +1,65 @@
|
|||
{
|
||||
"task_id": "task_create_api_tasks_list",
|
||||
"entity_id": "api_tasks_list",
|
||||
"generated_at": "2025-12-18T01:57:52.722869",
|
||||
"workflow_version": "v001",
|
||||
"target": {
|
||||
"type": "api",
|
||||
"definition": {
|
||||
"id": "api_tasks_list",
|
||||
"path": "/api/tasks",
|
||||
"method": "GET",
|
||||
"description": "List all available tasks",
|
||||
"file_path": "app/api/tasks/route.ts",
|
||||
"status": "PENDING",
|
||||
"auth_required": true,
|
||||
"responses": [
|
||||
{
|
||||
"status": 200,
|
||||
"description": "Success",
|
||||
"schema": {
|
||||
"tasks": [
|
||||
{
|
||||
"id": "string",
|
||||
"type": "string",
|
||||
"title": "string",
|
||||
"description": "string",
|
||||
"points_reward": "integer",
|
||||
"is_completed_today": "boolean"
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
},
|
||||
"related": {
|
||||
"models": [],
|
||||
"apis": [],
|
||||
"components": []
|
||||
},
|
||||
"dependencies": {
|
||||
"entity_ids": [],
|
||||
"definitions": []
|
||||
},
|
||||
"files": {
|
||||
"to_create": [
|
||||
"app/api/tasks/route.ts"
|
||||
],
|
||||
"reference": []
|
||||
},
|
||||
"acceptance": [
|
||||
{
|
||||
"criterion": "GET /api/tasks returns success response",
|
||||
"verification": "curl -X GET /api/tasks"
|
||||
},
|
||||
{
|
||||
"criterion": "Request validation implemented",
|
||||
"verification": "Test with invalid data"
|
||||
},
|
||||
{
|
||||
"criterion": "Error responses match contract",
|
||||
"verification": "Test error scenarios"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
|
@ -0,0 +1,64 @@
|
|||
{
|
||||
"task_id": "task_create_api_users_badges",
|
||||
"entity_id": "api_users_badges",
|
||||
"generated_at": "2025-12-18T01:57:52.722788",
|
||||
"workflow_version": "v001",
|
||||
"target": {
|
||||
"type": "api",
|
||||
"definition": {
|
||||
"id": "api_users_badges",
|
||||
"path": "/api/users/me/badges",
|
||||
"method": "GET",
|
||||
"description": "Get user earned badges",
|
||||
"file_path": "app/api/users/me/badges/route.ts",
|
||||
"status": "PENDING",
|
||||
"auth_required": true,
|
||||
"responses": [
|
||||
{
|
||||
"status": 200,
|
||||
"description": "Success",
|
||||
"schema": {
|
||||
"badges": [
|
||||
{
|
||||
"id": "string",
|
||||
"name": "string",
|
||||
"description": "string",
|
||||
"icon": "string",
|
||||
"earned_at": "string (ISO date)"
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
},
|
||||
"related": {
|
||||
"models": [],
|
||||
"apis": [],
|
||||
"components": []
|
||||
},
|
||||
"dependencies": {
|
||||
"entity_ids": [],
|
||||
"definitions": []
|
||||
},
|
||||
"files": {
|
||||
"to_create": [
|
||||
"app/api/users/me/badges/route.ts"
|
||||
],
|
||||
"reference": []
|
||||
},
|
||||
"acceptance": [
|
||||
{
|
||||
"criterion": "GET /api/users/me/badges returns success response",
|
||||
"verification": "curl -X GET /api/users/me/badges"
|
||||
},
|
||||
{
|
||||
"criterion": "Request validation implemented",
|
||||
"verification": "Test with invalid data"
|
||||
},
|
||||
{
|
||||
"criterion": "Error responses match contract",
|
||||
"verification": "Test error scenarios"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
|
@ -0,0 +1,65 @@
|
|||
{
|
||||
"task_id": "task_create_api_users_points",
|
||||
"entity_id": "api_users_points",
|
||||
"generated_at": "2025-12-18T01:57:52.722710",
|
||||
"workflow_version": "v001",
|
||||
"target": {
|
||||
"type": "api",
|
||||
"definition": {
|
||||
"id": "api_users_points",
|
||||
"path": "/api/users/me/points",
|
||||
"method": "GET",
|
||||
"description": "Get user points balance and transaction history",
|
||||
"file_path": "app/api/users/me/points/route.ts",
|
||||
"status": "PENDING",
|
||||
"auth_required": true,
|
||||
"responses": [
|
||||
{
|
||||
"status": 200,
|
||||
"description": "Success",
|
||||
"schema": {
|
||||
"balance": "integer",
|
||||
"transactions": [
|
||||
{
|
||||
"id": "string",
|
||||
"amount": "integer",
|
||||
"type": "string",
|
||||
"source": "string",
|
||||
"created_at": "string (ISO date)"
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
},
|
||||
"related": {
|
||||
"models": [],
|
||||
"apis": [],
|
||||
"components": []
|
||||
},
|
||||
"dependencies": {
|
||||
"entity_ids": [],
|
||||
"definitions": []
|
||||
},
|
||||
"files": {
|
||||
"to_create": [
|
||||
"app/api/users/me/points/route.ts"
|
||||
],
|
||||
"reference": []
|
||||
},
|
||||
"acceptance": [
|
||||
{
|
||||
"criterion": "GET /api/users/me/points returns success response",
|
||||
"verification": "curl -X GET /api/users/me/points"
|
||||
},
|
||||
{
|
||||
"criterion": "Request validation implemented",
|
||||
"verification": "Test with invalid data"
|
||||
},
|
||||
{
|
||||
"criterion": "Error responses match contract",
|
||||
"verification": "Test error scenarios"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
|
@ -0,0 +1,58 @@
|
|||
{
|
||||
"task_id": "task_create_component_auth_form",
|
||||
"entity_id": "component_auth_form",
|
||||
"generated_at": "2025-12-18T01:57:52.724088",
|
||||
"workflow_version": "v001",
|
||||
"target": {
|
||||
"type": "component",
|
||||
"definition": {
|
||||
"id": "component_auth_form",
|
||||
"name": "AuthForm",
|
||||
"description": "Reusable login/register form component",
|
||||
"file_path": "app/components/AuthForm.tsx",
|
||||
"status": "PENDING",
|
||||
"props": {
|
||||
"mode": "'login' | 'register'",
|
||||
"onSubmit": "(data: AuthData) => Promise<void>",
|
||||
"error": "string | null"
|
||||
},
|
||||
"features": [
|
||||
"Email and password inputs",
|
||||
"Name input (register mode only)",
|
||||
"Client-side validation",
|
||||
"Error display",
|
||||
"Loading state",
|
||||
"Submit button"
|
||||
]
|
||||
}
|
||||
},
|
||||
"related": {
|
||||
"models": [],
|
||||
"apis": [],
|
||||
"components": []
|
||||
},
|
||||
"dependencies": {
|
||||
"entity_ids": [],
|
||||
"definitions": []
|
||||
},
|
||||
"files": {
|
||||
"to_create": [
|
||||
"app/components/AuthForm.tsx"
|
||||
],
|
||||
"reference": []
|
||||
},
|
||||
"acceptance": [
|
||||
{
|
||||
"criterion": "Component renders without errors",
|
||||
"verification": "Import and render in test"
|
||||
},
|
||||
{
|
||||
"criterion": "Props are typed correctly",
|
||||
"verification": "TypeScript compilation"
|
||||
},
|
||||
{
|
||||
"criterion": "Events fire correctly",
|
||||
"verification": "Test event handlers"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
|
@ -0,0 +1,57 @@
|
|||
{
|
||||
"task_id": "task_create_component_badge_card",
|
||||
"entity_id": "component_badge_card",
|
||||
"generated_at": "2025-12-18T01:57:52.724450",
|
||||
"workflow_version": "v001",
|
||||
"target": {
|
||||
"type": "component",
|
||||
"definition": {
|
||||
"id": "component_badge_card",
|
||||
"name": "BadgeCard",
|
||||
"description": "Display a badge or achievement",
|
||||
"file_path": "app/components/BadgeCard.tsx",
|
||||
"status": "PENDING",
|
||||
"props": {
|
||||
"badge": "Badge object",
|
||||
"earned": "boolean",
|
||||
"earnedAt": "Date | null"
|
||||
},
|
||||
"features": [
|
||||
"Badge icon display",
|
||||
"Badge name and description",
|
||||
"Earned/locked state",
|
||||
"Earned date (if earned)",
|
||||
"Tooltip with requirement"
|
||||
]
|
||||
}
|
||||
},
|
||||
"related": {
|
||||
"models": [],
|
||||
"apis": [],
|
||||
"components": []
|
||||
},
|
||||
"dependencies": {
|
||||
"entity_ids": [],
|
||||
"definitions": []
|
||||
},
|
||||
"files": {
|
||||
"to_create": [
|
||||
"app/components/BadgeCard.tsx"
|
||||
],
|
||||
"reference": []
|
||||
},
|
||||
"acceptance": [
|
||||
{
|
||||
"criterion": "Component renders without errors",
|
||||
"verification": "Import and render in test"
|
||||
},
|
||||
{
|
||||
"criterion": "Props are typed correctly",
|
||||
"verification": "TypeScript compilation"
|
||||
},
|
||||
{
|
||||
"criterion": "Events fire correctly",
|
||||
"verification": "Test event handlers"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
|
@ -0,0 +1,57 @@
|
|||
{
|
||||
"task_id": "task_create_component_daily_checkin_button",
|
||||
"entity_id": "component_daily_checkin_button",
|
||||
"generated_at": "2025-12-18T01:57:52.724595",
|
||||
"workflow_version": "v001",
|
||||
"target": {
|
||||
"type": "component",
|
||||
"definition": {
|
||||
"id": "component_daily_checkin_button",
|
||||
"name": "DailyCheckinButton",
|
||||
"description": "Check-in button with streak display",
|
||||
"file_path": "app/components/DailyCheckinButton.tsx",
|
||||
"status": "PENDING",
|
||||
"props": {
|
||||
"onCheckIn": "() => Promise<void>",
|
||||
"isCheckedInToday": "boolean",
|
||||
"streakDays": "number"
|
||||
},
|
||||
"features": [
|
||||
"Large prominent button",
|
||||
"Streak counter display",
|
||||
"Disabled state if already checked in",
|
||||
"Success animation",
|
||||
"Points earned display"
|
||||
]
|
||||
}
|
||||
},
|
||||
"related": {
|
||||
"models": [],
|
||||
"apis": [],
|
||||
"components": []
|
||||
},
|
||||
"dependencies": {
|
||||
"entity_ids": [],
|
||||
"definitions": []
|
||||
},
|
||||
"files": {
|
||||
"to_create": [
|
||||
"app/components/DailyCheckinButton.tsx"
|
||||
],
|
||||
"reference": []
|
||||
},
|
||||
"acceptance": [
|
||||
{
|
||||
"criterion": "Component renders without errors",
|
||||
"verification": "Import and render in test"
|
||||
},
|
||||
{
|
||||
"criterion": "Props are typed correctly",
|
||||
"verification": "TypeScript compilation"
|
||||
},
|
||||
{
|
||||
"criterion": "Events fire correctly",
|
||||
"verification": "Test event handlers"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
|
@ -0,0 +1,54 @@
|
|||
{
|
||||
"task_id": "task_create_component_dark_theme_layout",
|
||||
"entity_id": "component_dark_theme_layout",
|
||||
"generated_at": "2025-12-18T01:57:52.724806",
|
||||
"workflow_version": "v001",
|
||||
"target": {
|
||||
"type": "component",
|
||||
"definition": {
|
||||
"id": "component_dark_theme_layout",
|
||||
"name": "DarkThemeLayout",
|
||||
"description": "Root layout with dark theme",
|
||||
"file_path": "app/components/DarkThemeLayout.tsx",
|
||||
"status": "PENDING",
|
||||
"props": {
|
||||
"children": "React.ReactNode"
|
||||
},
|
||||
"features": [
|
||||
"Dark background colors",
|
||||
"Global dark theme CSS variables",
|
||||
"Consistent spacing and typography",
|
||||
"Tailwind CSS dark mode utilities"
|
||||
]
|
||||
}
|
||||
},
|
||||
"related": {
|
||||
"models": [],
|
||||
"apis": [],
|
||||
"components": []
|
||||
},
|
||||
"dependencies": {
|
||||
"entity_ids": [],
|
||||
"definitions": []
|
||||
},
|
||||
"files": {
|
||||
"to_create": [
|
||||
"app/components/DarkThemeLayout.tsx"
|
||||
],
|
||||
"reference": []
|
||||
},
|
||||
"acceptance": [
|
||||
{
|
||||
"criterion": "Component renders without errors",
|
||||
"verification": "Import and render in test"
|
||||
},
|
||||
{
|
||||
"criterion": "Props are typed correctly",
|
||||
"verification": "TypeScript compilation"
|
||||
},
|
||||
{
|
||||
"criterion": "Events fire correctly",
|
||||
"verification": "Test event handlers"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
|
@ -0,0 +1,56 @@
|
|||
{
|
||||
"task_id": "task_create_component_leaderboard_table",
|
||||
"entity_id": "component_leaderboard_table",
|
||||
"generated_at": "2025-12-18T01:57:52.724524",
|
||||
"workflow_version": "v001",
|
||||
"target": {
|
||||
"type": "component",
|
||||
"definition": {
|
||||
"id": "component_leaderboard_table",
|
||||
"name": "LeaderboardTable",
|
||||
"description": "Rankings table",
|
||||
"file_path": "app/components/LeaderboardTable.tsx",
|
||||
"status": "PENDING",
|
||||
"props": {
|
||||
"entries": "LeaderboardEntry[]",
|
||||
"currentUserId": "string"
|
||||
},
|
||||
"features": [
|
||||
"Table with rank, name, points columns",
|
||||
"Highlight current user row",
|
||||
"Top 3 special styling",
|
||||
"Responsive design",
|
||||
"Dark theme table styling"
|
||||
]
|
||||
}
|
||||
},
|
||||
"related": {
|
||||
"models": [],
|
||||
"apis": [],
|
||||
"components": []
|
||||
},
|
||||
"dependencies": {
|
||||
"entity_ids": [],
|
||||
"definitions": []
|
||||
},
|
||||
"files": {
|
||||
"to_create": [
|
||||
"app/components/LeaderboardTable.tsx"
|
||||
],
|
||||
"reference": []
|
||||
},
|
||||
"acceptance": [
|
||||
{
|
||||
"criterion": "Component renders without errors",
|
||||
"verification": "Import and render in test"
|
||||
},
|
||||
{
|
||||
"criterion": "Props are typed correctly",
|
||||
"verification": "TypeScript compilation"
|
||||
},
|
||||
{
|
||||
"criterion": "Events fire correctly",
|
||||
"verification": "Test event handlers"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
|
@ -0,0 +1,56 @@
|
|||
{
|
||||
"task_id": "task_create_component_navbar",
|
||||
"entity_id": "component_navbar",
|
||||
"generated_at": "2025-12-18T01:57:52.724737",
|
||||
"workflow_version": "v001",
|
||||
"target": {
|
||||
"type": "component",
|
||||
"definition": {
|
||||
"id": "component_navbar",
|
||||
"name": "Navbar",
|
||||
"description": "Main navigation bar",
|
||||
"file_path": "app/components/Navbar.tsx",
|
||||
"status": "PENDING",
|
||||
"props": {
|
||||
"currentPath": "string"
|
||||
},
|
||||
"features": [
|
||||
"Links to Dashboard, Tasks, Leaderboard, Profile, Referral",
|
||||
"Active link highlighting",
|
||||
"User menu with logout",
|
||||
"Points balance display",
|
||||
"Responsive mobile menu",
|
||||
"Dark theme styling"
|
||||
]
|
||||
}
|
||||
},
|
||||
"related": {
|
||||
"models": [],
|
||||
"apis": [],
|
||||
"components": []
|
||||
},
|
||||
"dependencies": {
|
||||
"entity_ids": [],
|
||||
"definitions": []
|
||||
},
|
||||
"files": {
|
||||
"to_create": [
|
||||
"app/components/Navbar.tsx"
|
||||
],
|
||||
"reference": []
|
||||
},
|
||||
"acceptance": [
|
||||
{
|
||||
"criterion": "Component renders without errors",
|
||||
"verification": "Import and render in test"
|
||||
},
|
||||
{
|
||||
"criterion": "Props are typed correctly",
|
||||
"verification": "TypeScript compilation"
|
||||
},
|
||||
{
|
||||
"criterion": "Events fire correctly",
|
||||
"verification": "Test event handlers"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
|
@ -0,0 +1,55 @@
|
|||
{
|
||||
"task_id": "task_create_component_points_display",
|
||||
"entity_id": "component_points_display",
|
||||
"generated_at": "2025-12-18T01:57:52.724158",
|
||||
"workflow_version": "v001",
|
||||
"target": {
|
||||
"type": "component",
|
||||
"definition": {
|
||||
"id": "component_points_display",
|
||||
"name": "PointsDisplay",
|
||||
"description": "Display current points balance",
|
||||
"file_path": "app/components/PointsDisplay.tsx",
|
||||
"status": "PENDING",
|
||||
"props": {
|
||||
"balance": "number",
|
||||
"showAnimation": "boolean (optional)"
|
||||
},
|
||||
"features": [
|
||||
"Large points number display",
|
||||
"Coin/points icon",
|
||||
"Optional animation on change",
|
||||
"Dark theme styling"
|
||||
]
|
||||
}
|
||||
},
|
||||
"related": {
|
||||
"models": [],
|
||||
"apis": [],
|
||||
"components": []
|
||||
},
|
||||
"dependencies": {
|
||||
"entity_ids": [],
|
||||
"definitions": []
|
||||
},
|
||||
"files": {
|
||||
"to_create": [
|
||||
"app/components/PointsDisplay.tsx"
|
||||
],
|
||||
"reference": []
|
||||
},
|
||||
"acceptance": [
|
||||
{
|
||||
"criterion": "Component renders without errors",
|
||||
"verification": "Import and render in test"
|
||||
},
|
||||
{
|
||||
"criterion": "Props are typed correctly",
|
||||
"verification": "TypeScript compilation"
|
||||
},
|
||||
{
|
||||
"criterion": "Events fire correctly",
|
||||
"verification": "Test event handlers"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
|
@ -0,0 +1,57 @@
|
|||
{
|
||||
"task_id": "task_create_component_quiz_question",
|
||||
"entity_id": "component_quiz_question",
|
||||
"generated_at": "2025-12-18T01:57:52.724372",
|
||||
"workflow_version": "v001",
|
||||
"target": {
|
||||
"type": "component",
|
||||
"definition": {
|
||||
"id": "component_quiz_question",
|
||||
"name": "QuizQuestion",
|
||||
"description": "Quiz question with multiple choice",
|
||||
"file_path": "app/components/QuizQuestion.tsx",
|
||||
"status": "PENDING",
|
||||
"props": {
|
||||
"question": "string",
|
||||
"options": "string[]",
|
||||
"onAnswer": "(answer: string) => void",
|
||||
"selectedAnswer": "string | null"
|
||||
},
|
||||
"features": [
|
||||
"Question text display",
|
||||
"Radio button options",
|
||||
"Highlight selected answer",
|
||||
"Dark theme styling"
|
||||
]
|
||||
}
|
||||
},
|
||||
"related": {
|
||||
"models": [],
|
||||
"apis": [],
|
||||
"components": []
|
||||
},
|
||||
"dependencies": {
|
||||
"entity_ids": [],
|
||||
"definitions": []
|
||||
},
|
||||
"files": {
|
||||
"to_create": [
|
||||
"app/components/QuizQuestion.tsx"
|
||||
],
|
||||
"reference": []
|
||||
},
|
||||
"acceptance": [
|
||||
{
|
||||
"criterion": "Component renders without errors",
|
||||
"verification": "Import and render in test"
|
||||
},
|
||||
{
|
||||
"criterion": "Props are typed correctly",
|
||||
"verification": "TypeScript compilation"
|
||||
},
|
||||
{
|
||||
"criterion": "Events fire correctly",
|
||||
"verification": "Test event handlers"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
|
@ -0,0 +1,58 @@
|
|||
{
|
||||
"task_id": "task_create_component_task_card",
|
||||
"entity_id": "component_task_card",
|
||||
"generated_at": "2025-12-18T01:57:52.724228",
|
||||
"workflow_version": "v001",
|
||||
"target": {
|
||||
"type": "component",
|
||||
"definition": {
|
||||
"id": "component_task_card",
|
||||
"name": "TaskCard",
|
||||
"description": "Display a single task",
|
||||
"file_path": "app/components/TaskCard.tsx",
|
||||
"status": "PENDING",
|
||||
"props": {
|
||||
"task": "Task object",
|
||||
"onComplete": "() => void",
|
||||
"isCompleted": "boolean"
|
||||
},
|
||||
"features": [
|
||||
"Task title and description",
|
||||
"Points reward badge",
|
||||
"Task type icon",
|
||||
"Completion status",
|
||||
"Complete button",
|
||||
"Dark theme card styling"
|
||||
]
|
||||
}
|
||||
},
|
||||
"related": {
|
||||
"models": [],
|
||||
"apis": [],
|
||||
"components": []
|
||||
},
|
||||
"dependencies": {
|
||||
"entity_ids": [],
|
||||
"definitions": []
|
||||
},
|
||||
"files": {
|
||||
"to_create": [
|
||||
"app/components/TaskCard.tsx"
|
||||
],
|
||||
"reference": []
|
||||
},
|
||||
"acceptance": [
|
||||
{
|
||||
"criterion": "Component renders without errors",
|
||||
"verification": "Import and render in test"
|
||||
},
|
||||
{
|
||||
"criterion": "Props are typed correctly",
|
||||
"verification": "TypeScript compilation"
|
||||
},
|
||||
{
|
||||
"criterion": "Events fire correctly",
|
||||
"verification": "Test event handlers"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
|
@ -0,0 +1,55 @@
|
|||
{
|
||||
"task_id": "task_create_component_task_list",
|
||||
"entity_id": "component_task_list",
|
||||
"generated_at": "2025-12-18T01:57:52.724299",
|
||||
"workflow_version": "v001",
|
||||
"target": {
|
||||
"type": "component",
|
||||
"definition": {
|
||||
"id": "component_task_list",
|
||||
"name": "TaskList",
|
||||
"description": "List of task cards with filtering",
|
||||
"file_path": "app/components/TaskList.tsx",
|
||||
"status": "PENDING",
|
||||
"props": {
|
||||
"tasks": "Task[]",
|
||||
"onTaskComplete": "(taskId: string) => void"
|
||||
},
|
||||
"features": [
|
||||
"Grid layout of TaskCard components",
|
||||
"Filter by task type",
|
||||
"Empty state message",
|
||||
"Loading state"
|
||||
]
|
||||
}
|
||||
},
|
||||
"related": {
|
||||
"models": [],
|
||||
"apis": [],
|
||||
"components": []
|
||||
},
|
||||
"dependencies": {
|
||||
"entity_ids": [],
|
||||
"definitions": []
|
||||
},
|
||||
"files": {
|
||||
"to_create": [
|
||||
"app/components/TaskList.tsx"
|
||||
],
|
||||
"reference": []
|
||||
},
|
||||
"acceptance": [
|
||||
{
|
||||
"criterion": "Component renders without errors",
|
||||
"verification": "Import and render in test"
|
||||
},
|
||||
{
|
||||
"criterion": "Props are typed correctly",
|
||||
"verification": "TypeScript compilation"
|
||||
},
|
||||
{
|
||||
"criterion": "Events fire correctly",
|
||||
"verification": "Test event handlers"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
|
@ -0,0 +1,55 @@
|
|||
{
|
||||
"task_id": "task_create_component_transaction_history",
|
||||
"entity_id": "component_transaction_history",
|
||||
"generated_at": "2025-12-18T01:57:52.724666",
|
||||
"workflow_version": "v001",
|
||||
"target": {
|
||||
"type": "component",
|
||||
"definition": {
|
||||
"id": "component_transaction_history",
|
||||
"name": "TransactionHistory",
|
||||
"description": "List of points transactions",
|
||||
"file_path": "app/components/TransactionHistory.tsx",
|
||||
"status": "PENDING",
|
||||
"props": {
|
||||
"transactions": "Transaction[]"
|
||||
},
|
||||
"features": [
|
||||
"List of transactions with date, amount, source",
|
||||
"Color coding (green for earned, red for spent)",
|
||||
"Pagination or infinite scroll",
|
||||
"Empty state message",
|
||||
"Dark theme styling"
|
||||
]
|
||||
}
|
||||
},
|
||||
"related": {
|
||||
"models": [],
|
||||
"apis": [],
|
||||
"components": []
|
||||
},
|
||||
"dependencies": {
|
||||
"entity_ids": [],
|
||||
"definitions": []
|
||||
},
|
||||
"files": {
|
||||
"to_create": [
|
||||
"app/components/TransactionHistory.tsx"
|
||||
],
|
||||
"reference": []
|
||||
},
|
||||
"acceptance": [
|
||||
{
|
||||
"criterion": "Component renders without errors",
|
||||
"verification": "Import and render in test"
|
||||
},
|
||||
{
|
||||
"criterion": "Props are typed correctly",
|
||||
"verification": "TypeScript compilation"
|
||||
},
|
||||
{
|
||||
"criterion": "Events fire correctly",
|
||||
"verification": "Test event handlers"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
|
@ -0,0 +1,93 @@
|
|||
{
|
||||
"task_id": "task_create_model_badge",
|
||||
"entity_id": "model_badge",
|
||||
"generated_at": "2025-12-18T01:57:52.722103",
|
||||
"workflow_version": "v001",
|
||||
"target": {
|
||||
"type": "model",
|
||||
"definition": {
|
||||
"id": "model_badge",
|
||||
"name": "Badge",
|
||||
"description": "Available badges and achievements",
|
||||
"file_path": "app/lib/db/schema/badge.ts",
|
||||
"status": "PENDING",
|
||||
"fields": [
|
||||
{
|
||||
"name": "id",
|
||||
"type": "string",
|
||||
"required": true,
|
||||
"description": "Unique badge identifier (UUID)",
|
||||
"constraints": [
|
||||
"primary_key"
|
||||
]
|
||||
},
|
||||
{
|
||||
"name": "name",
|
||||
"type": "string",
|
||||
"required": true,
|
||||
"description": "Badge display name"
|
||||
},
|
||||
{
|
||||
"name": "description",
|
||||
"type": "string",
|
||||
"required": true,
|
||||
"description": "Badge description"
|
||||
},
|
||||
{
|
||||
"name": "icon",
|
||||
"type": "string",
|
||||
"required": true,
|
||||
"description": "Badge icon identifier or URL"
|
||||
},
|
||||
{
|
||||
"name": "requirement_type",
|
||||
"type": "enum",
|
||||
"required": true,
|
||||
"description": "Type of requirement to earn badge",
|
||||
"enum_values": [
|
||||
"points_total",
|
||||
"tasks_completed",
|
||||
"streak_days",
|
||||
"referrals"
|
||||
]
|
||||
},
|
||||
{
|
||||
"name": "requirement_value",
|
||||
"type": "integer",
|
||||
"required": true,
|
||||
"description": "Threshold value for requirement"
|
||||
}
|
||||
]
|
||||
}
|
||||
},
|
||||
"related": {
|
||||
"models": [],
|
||||
"apis": [],
|
||||
"components": []
|
||||
},
|
||||
"dependencies": {
|
||||
"entity_ids": [],
|
||||
"definitions": []
|
||||
},
|
||||
"files": {
|
||||
"to_create": [
|
||||
"prisma/schema.prisma",
|
||||
"app/models/badge.ts"
|
||||
],
|
||||
"reference": []
|
||||
},
|
||||
"acceptance": [
|
||||
{
|
||||
"criterion": "Model defined in Prisma schema",
|
||||
"verification": "Check prisma/schema.prisma"
|
||||
},
|
||||
{
|
||||
"criterion": "TypeScript types exported",
|
||||
"verification": "Import type in test file"
|
||||
},
|
||||
{
|
||||
"criterion": "Relations properly configured",
|
||||
"verification": "Check Prisma relations"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
|
@ -0,0 +1,100 @@
|
|||
{
|
||||
"task_id": "task_create_model_points",
|
||||
"entity_id": "model_points",
|
||||
"generated_at": "2025-12-18T01:57:52.721807",
|
||||
"workflow_version": "v001",
|
||||
"target": {
|
||||
"type": "model",
|
||||
"definition": {
|
||||
"id": "model_points",
|
||||
"name": "Points",
|
||||
"description": "Points transaction history",
|
||||
"file_path": "app/lib/db/schema/points.ts",
|
||||
"status": "PENDING",
|
||||
"fields": [
|
||||
{
|
||||
"name": "id",
|
||||
"type": "string",
|
||||
"required": true,
|
||||
"description": "Unique transaction identifier (UUID)",
|
||||
"constraints": [
|
||||
"primary_key"
|
||||
]
|
||||
},
|
||||
{
|
||||
"name": "user_id",
|
||||
"type": "string",
|
||||
"required": true,
|
||||
"description": "Foreign key to User"
|
||||
},
|
||||
{
|
||||
"name": "amount",
|
||||
"type": "integer",
|
||||
"required": true,
|
||||
"description": "Points amount (positive for earned, negative for spent)"
|
||||
},
|
||||
{
|
||||
"name": "type",
|
||||
"type": "enum",
|
||||
"required": true,
|
||||
"description": "Transaction type",
|
||||
"enum_values": [
|
||||
"earned",
|
||||
"spent"
|
||||
]
|
||||
},
|
||||
{
|
||||
"name": "source",
|
||||
"type": "string",
|
||||
"required": true,
|
||||
"description": "Source of points (task_id, purchase_id, etc.)"
|
||||
},
|
||||
{
|
||||
"name": "created_at",
|
||||
"type": "timestamp",
|
||||
"required": true,
|
||||
"description": "Transaction timestamp"
|
||||
}
|
||||
],
|
||||
"indexes": [
|
||||
{
|
||||
"fields": [
|
||||
"user_id",
|
||||
"created_at"
|
||||
],
|
||||
"unique": false
|
||||
}
|
||||
]
|
||||
}
|
||||
},
|
||||
"related": {
|
||||
"models": [],
|
||||
"apis": [],
|
||||
"components": []
|
||||
},
|
||||
"dependencies": {
|
||||
"entity_ids": [],
|
||||
"definitions": []
|
||||
},
|
||||
"files": {
|
||||
"to_create": [
|
||||
"prisma/schema.prisma",
|
||||
"app/models/points.ts"
|
||||
],
|
||||
"reference": []
|
||||
},
|
||||
"acceptance": [
|
||||
{
|
||||
"criterion": "Model defined in Prisma schema",
|
||||
"verification": "Check prisma/schema.prisma"
|
||||
},
|
||||
{
|
||||
"criterion": "TypeScript types exported",
|
||||
"verification": "Import type in test file"
|
||||
},
|
||||
{
|
||||
"criterion": "Relations properly configured",
|
||||
"verification": "Check Prisma relations"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
|
@ -0,0 +1,89 @@
|
|||
{
|
||||
"task_id": "task_create_model_quiz",
|
||||
"entity_id": "model_quiz",
|
||||
"generated_at": "2025-12-18T01:57:52.722279",
|
||||
"workflow_version": "v001",
|
||||
"target": {
|
||||
"type": "model",
|
||||
"definition": {
|
||||
"id": "model_quiz",
|
||||
"name": "Quiz",
|
||||
"description": "Quiz questions for learning tasks",
|
||||
"file_path": "app/lib/db/schema/quiz.ts",
|
||||
"status": "PENDING",
|
||||
"fields": [
|
||||
{
|
||||
"name": "id",
|
||||
"type": "string",
|
||||
"required": true,
|
||||
"description": "Unique quiz identifier (UUID)",
|
||||
"constraints": [
|
||||
"primary_key"
|
||||
]
|
||||
},
|
||||
{
|
||||
"name": "task_id",
|
||||
"type": "string",
|
||||
"required": true,
|
||||
"description": "Foreign key to Task"
|
||||
},
|
||||
{
|
||||
"name": "question",
|
||||
"type": "string",
|
||||
"required": true,
|
||||
"description": "Quiz question text"
|
||||
},
|
||||
{
|
||||
"name": "options",
|
||||
"type": "json",
|
||||
"required": true,
|
||||
"description": "Array of answer options"
|
||||
},
|
||||
{
|
||||
"name": "correct_answer",
|
||||
"type": "string",
|
||||
"required": true,
|
||||
"description": "Correct answer identifier"
|
||||
}
|
||||
],
|
||||
"indexes": [
|
||||
{
|
||||
"fields": [
|
||||
"task_id"
|
||||
],
|
||||
"unique": false
|
||||
}
|
||||
]
|
||||
}
|
||||
},
|
||||
"related": {
|
||||
"models": [],
|
||||
"apis": [],
|
||||
"components": []
|
||||
},
|
||||
"dependencies": {
|
||||
"entity_ids": [],
|
||||
"definitions": []
|
||||
},
|
||||
"files": {
|
||||
"to_create": [
|
||||
"prisma/schema.prisma",
|
||||
"app/models/quiz.ts"
|
||||
],
|
||||
"reference": []
|
||||
},
|
||||
"acceptance": [
|
||||
{
|
||||
"criterion": "Model defined in Prisma schema",
|
||||
"verification": "Check prisma/schema.prisma"
|
||||
},
|
||||
{
|
||||
"criterion": "TypeScript types exported",
|
||||
"verification": "Import type in test file"
|
||||
},
|
||||
{
|
||||
"criterion": "Relations properly configured",
|
||||
"verification": "Check Prisma relations"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
|
@ -0,0 +1,95 @@
|
|||
{
|
||||
"task_id": "task_create_model_referral",
|
||||
"entity_id": "model_referral",
|
||||
"generated_at": "2025-12-18T01:57:52.722366",
|
||||
"workflow_version": "v001",
|
||||
"target": {
|
||||
"type": "model",
|
||||
"definition": {
|
||||
"id": "model_referral",
|
||||
"name": "Referral",
|
||||
"description": "Referral tracking and rewards",
|
||||
"file_path": "app/lib/db/schema/referral.ts",
|
||||
"status": "PENDING",
|
||||
"fields": [
|
||||
{
|
||||
"name": "id",
|
||||
"type": "string",
|
||||
"required": true,
|
||||
"description": "Unique referral identifier (UUID)",
|
||||
"constraints": [
|
||||
"primary_key"
|
||||
]
|
||||
},
|
||||
{
|
||||
"name": "referrer_id",
|
||||
"type": "string",
|
||||
"required": true,
|
||||
"description": "Foreign key to User (who referred)"
|
||||
},
|
||||
{
|
||||
"name": "referred_id",
|
||||
"type": "string",
|
||||
"required": true,
|
||||
"description": "Foreign key to User (who was referred)"
|
||||
},
|
||||
{
|
||||
"name": "bonus_points",
|
||||
"type": "integer",
|
||||
"required": true,
|
||||
"description": "Points awarded to referrer"
|
||||
},
|
||||
{
|
||||
"name": "created_at",
|
||||
"type": "timestamp",
|
||||
"required": true,
|
||||
"description": "Referral creation timestamp"
|
||||
}
|
||||
],
|
||||
"indexes": [
|
||||
{
|
||||
"fields": [
|
||||
"referrer_id"
|
||||
],
|
||||
"unique": false
|
||||
},
|
||||
{
|
||||
"fields": [
|
||||
"referred_id"
|
||||
],
|
||||
"unique": true
|
||||
}
|
||||
]
|
||||
}
|
||||
},
|
||||
"related": {
|
||||
"models": [],
|
||||
"apis": [],
|
||||
"components": []
|
||||
},
|
||||
"dependencies": {
|
||||
"entity_ids": [],
|
||||
"definitions": []
|
||||
},
|
||||
"files": {
|
||||
"to_create": [
|
||||
"prisma/schema.prisma",
|
||||
"app/models/referral.ts"
|
||||
],
|
||||
"reference": []
|
||||
},
|
||||
"acceptance": [
|
||||
{
|
||||
"criterion": "Model defined in Prisma schema",
|
||||
"verification": "Check prisma/schema.prisma"
|
||||
},
|
||||
{
|
||||
"criterion": "TypeScript types exported",
|
||||
"verification": "Import type in test file"
|
||||
},
|
||||
{
|
||||
"criterion": "Relations properly configured",
|
||||
"verification": "Check Prisma relations"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
|
@ -0,0 +1,105 @@
|
|||
{
|
||||
"task_id": "task_create_model_task",
|
||||
"entity_id": "model_task",
|
||||
"generated_at": "2025-12-18T01:57:52.721911",
|
||||
"workflow_version": "v001",
|
||||
"target": {
|
||||
"type": "model",
|
||||
"definition": {
|
||||
"id": "model_task",
|
||||
"name": "Task",
|
||||
"description": "Available tasks for earning points",
|
||||
"file_path": "app/lib/db/schema/task.ts",
|
||||
"status": "PENDING",
|
||||
"fields": [
|
||||
{
|
||||
"name": "id",
|
||||
"type": "string",
|
||||
"required": true,
|
||||
"description": "Unique task identifier (UUID)",
|
||||
"constraints": [
|
||||
"primary_key"
|
||||
]
|
||||
},
|
||||
{
|
||||
"name": "type",
|
||||
"type": "enum",
|
||||
"required": true,
|
||||
"description": "Task category",
|
||||
"enum_values": [
|
||||
"checkin",
|
||||
"ad",
|
||||
"survey",
|
||||
"referral",
|
||||
"quiz",
|
||||
"video",
|
||||
"reading"
|
||||
]
|
||||
},
|
||||
{
|
||||
"name": "title",
|
||||
"type": "string",
|
||||
"required": true,
|
||||
"description": "Task display title"
|
||||
},
|
||||
{
|
||||
"name": "description",
|
||||
"type": "string",
|
||||
"required": true,
|
||||
"description": "Task description"
|
||||
},
|
||||
{
|
||||
"name": "points_reward",
|
||||
"type": "integer",
|
||||
"required": true,
|
||||
"description": "Points awarded upon completion"
|
||||
},
|
||||
{
|
||||
"name": "is_active",
|
||||
"type": "boolean",
|
||||
"required": true,
|
||||
"description": "Whether task is currently available"
|
||||
}
|
||||
],
|
||||
"indexes": [
|
||||
{
|
||||
"fields": [
|
||||
"type",
|
||||
"is_active"
|
||||
],
|
||||
"unique": false
|
||||
}
|
||||
]
|
||||
}
|
||||
},
|
||||
"related": {
|
||||
"models": [],
|
||||
"apis": [],
|
||||
"components": []
|
||||
},
|
||||
"dependencies": {
|
||||
"entity_ids": [],
|
||||
"definitions": []
|
||||
},
|
||||
"files": {
|
||||
"to_create": [
|
||||
"prisma/schema.prisma",
|
||||
"app/models/task.ts"
|
||||
],
|
||||
"reference": []
|
||||
},
|
||||
"acceptance": [
|
||||
{
|
||||
"criterion": "Model defined in Prisma schema",
|
||||
"verification": "Check prisma/schema.prisma"
|
||||
},
|
||||
{
|
||||
"criterion": "TypeScript types exported",
|
||||
"verification": "Import type in test file"
|
||||
},
|
||||
{
|
||||
"criterion": "Relations properly configured",
|
||||
"verification": "Check Prisma relations"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
|
@ -0,0 +1,95 @@
|
|||
{
|
||||
"task_id": "task_create_model_user",
|
||||
"entity_id": "model_user",
|
||||
"generated_at": "2025-12-18T01:57:52.721672",
|
||||
"workflow_version": "v001",
|
||||
"target": {
|
||||
"type": "model",
|
||||
"definition": {
|
||||
"id": "model_user",
|
||||
"name": "User",
|
||||
"description": "User account and authentication",
|
||||
"file_path": "app/lib/db/schema/user.ts",
|
||||
"status": "PENDING",
|
||||
"fields": [
|
||||
{
|
||||
"name": "id",
|
||||
"type": "string",
|
||||
"required": true,
|
||||
"description": "Unique user identifier (UUID)",
|
||||
"constraints": [
|
||||
"primary_key"
|
||||
]
|
||||
},
|
||||
{
|
||||
"name": "email",
|
||||
"type": "string",
|
||||
"required": true,
|
||||
"description": "User email address (unique)"
|
||||
},
|
||||
{
|
||||
"name": "password_hash",
|
||||
"type": "string",
|
||||
"required": true,
|
||||
"description": "Hashed password using bcrypt"
|
||||
},
|
||||
{
|
||||
"name": "name",
|
||||
"type": "string",
|
||||
"required": true,
|
||||
"description": "User display name"
|
||||
},
|
||||
{
|
||||
"name": "created_at",
|
||||
"type": "timestamp",
|
||||
"required": true,
|
||||
"description": "Account creation timestamp"
|
||||
},
|
||||
{
|
||||
"name": "updated_at",
|
||||
"type": "timestamp",
|
||||
"required": true,
|
||||
"description": "Last update timestamp"
|
||||
}
|
||||
],
|
||||
"indexes": [
|
||||
{
|
||||
"fields": [
|
||||
"email"
|
||||
],
|
||||
"unique": true
|
||||
}
|
||||
]
|
||||
}
|
||||
},
|
||||
"related": {
|
||||
"models": [],
|
||||
"apis": [],
|
||||
"components": []
|
||||
},
|
||||
"dependencies": {
|
||||
"entity_ids": [],
|
||||
"definitions": []
|
||||
},
|
||||
"files": {
|
||||
"to_create": [
|
||||
"prisma/schema.prisma",
|
||||
"app/models/user.ts"
|
||||
],
|
||||
"reference": []
|
||||
},
|
||||
"acceptance": [
|
||||
{
|
||||
"criterion": "Model defined in Prisma schema",
|
||||
"verification": "Check prisma/schema.prisma"
|
||||
},
|
||||
{
|
||||
"criterion": "TypeScript types exported",
|
||||
"verification": "Import type in test file"
|
||||
},
|
||||
{
|
||||
"criterion": "Relations properly configured",
|
||||
"verification": "Check Prisma relations"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
|
@ -0,0 +1,84 @@
|
|||
{
|
||||
"task_id": "task_create_model_user_badge",
|
||||
"entity_id": "model_user_badge",
|
||||
"generated_at": "2025-12-18T01:57:52.722194",
|
||||
"workflow_version": "v001",
|
||||
"target": {
|
||||
"type": "model",
|
||||
"definition": {
|
||||
"id": "model_user_badge",
|
||||
"name": "UserBadge",
|
||||
"description": "User earned badges",
|
||||
"file_path": "app/lib/db/schema/user_badge.ts",
|
||||
"status": "PENDING",
|
||||
"fields": [
|
||||
{
|
||||
"name": "id",
|
||||
"type": "string",
|
||||
"required": true,
|
||||
"description": "Unique user badge identifier (UUID)",
|
||||
"constraints": [
|
||||
"primary_key"
|
||||
]
|
||||
},
|
||||
{
|
||||
"name": "user_id",
|
||||
"type": "string",
|
||||
"required": true,
|
||||
"description": "Foreign key to User"
|
||||
},
|
||||
{
|
||||
"name": "badge_id",
|
||||
"type": "string",
|
||||
"required": true,
|
||||
"description": "Foreign key to Badge"
|
||||
},
|
||||
{
|
||||
"name": "earned_at",
|
||||
"type": "timestamp",
|
||||
"required": true,
|
||||
"description": "Badge earned timestamp"
|
||||
}
|
||||
],
|
||||
"indexes": [
|
||||
{
|
||||
"fields": [
|
||||
"user_id",
|
||||
"badge_id"
|
||||
],
|
||||
"unique": true
|
||||
}
|
||||
]
|
||||
}
|
||||
},
|
||||
"related": {
|
||||
"models": [],
|
||||
"apis": [],
|
||||
"components": []
|
||||
},
|
||||
"dependencies": {
|
||||
"entity_ids": [],
|
||||
"definitions": []
|
||||
},
|
||||
"files": {
|
||||
"to_create": [
|
||||
"prisma/schema.prisma",
|
||||
"app/models/userbadge.ts"
|
||||
],
|
||||
"reference": []
|
||||
},
|
||||
"acceptance": [
|
||||
{
|
||||
"criterion": "Model defined in Prisma schema",
|
||||
"verification": "Check prisma/schema.prisma"
|
||||
},
|
||||
{
|
||||
"criterion": "TypeScript types exported",
|
||||
"verification": "Import type in test file"
|
||||
},
|
||||
{
|
||||
"criterion": "Relations properly configured",
|
||||
"verification": "Check Prisma relations"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
|
@ -0,0 +1,91 @@
|
|||
{
|
||||
"task_id": "task_create_model_user_task",
|
||||
"entity_id": "model_user_task",
|
||||
"generated_at": "2025-12-18T01:57:52.722010",
|
||||
"workflow_version": "v001",
|
||||
"target": {
|
||||
"type": "model",
|
||||
"definition": {
|
||||
"id": "model_user_task",
|
||||
"name": "UserTask",
|
||||
"description": "User task completion records",
|
||||
"file_path": "app/lib/db/schema/user_task.ts",
|
||||
"status": "PENDING",
|
||||
"fields": [
|
||||
{
|
||||
"name": "id",
|
||||
"type": "string",
|
||||
"required": true,
|
||||
"description": "Unique completion record identifier (UUID)",
|
||||
"constraints": [
|
||||
"primary_key"
|
||||
]
|
||||
},
|
||||
{
|
||||
"name": "user_id",
|
||||
"type": "string",
|
||||
"required": true,
|
||||
"description": "Foreign key to User"
|
||||
},
|
||||
{
|
||||
"name": "task_id",
|
||||
"type": "string",
|
||||
"required": true,
|
||||
"description": "Foreign key to Task"
|
||||
},
|
||||
{
|
||||
"name": "completed_at",
|
||||
"type": "timestamp",
|
||||
"required": true,
|
||||
"description": "Task completion timestamp"
|
||||
},
|
||||
{
|
||||
"name": "points_earned",
|
||||
"type": "integer",
|
||||
"required": true,
|
||||
"description": "Points awarded for this completion"
|
||||
}
|
||||
],
|
||||
"indexes": [
|
||||
{
|
||||
"fields": [
|
||||
"user_id",
|
||||
"task_id",
|
||||
"completed_at"
|
||||
],
|
||||
"unique": false
|
||||
}
|
||||
]
|
||||
}
|
||||
},
|
||||
"related": {
|
||||
"models": [],
|
||||
"apis": [],
|
||||
"components": []
|
||||
},
|
||||
"dependencies": {
|
||||
"entity_ids": [],
|
||||
"definitions": []
|
||||
},
|
||||
"files": {
|
||||
"to_create": [
|
||||
"prisma/schema.prisma",
|
||||
"app/models/usertask.ts"
|
||||
],
|
||||
"reference": []
|
||||
},
|
||||
"acceptance": [
|
||||
{
|
||||
"criterion": "Model defined in Prisma schema",
|
||||
"verification": "Check prisma/schema.prisma"
|
||||
},
|
||||
{
|
||||
"criterion": "TypeScript types exported",
|
||||
"verification": "Import type in test file"
|
||||
},
|
||||
{
|
||||
"criterion": "Relations properly configured",
|
||||
"verification": "Check Prisma relations"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
|
@ -0,0 +1,61 @@
|
|||
{
|
||||
"task_id": "task_create_page_dashboard",
|
||||
"entity_id": "page_dashboard",
|
||||
"generated_at": "2025-12-18T01:57:52.723646",
|
||||
"workflow_version": "v001",
|
||||
"target": {
|
||||
"type": "page",
|
||||
"definition": {
|
||||
"id": "page_dashboard",
|
||||
"name": "Dashboard",
|
||||
"description": "Main dashboard with overview",
|
||||
"file_path": "app/page.tsx",
|
||||
"status": "PENDING",
|
||||
"auth_required": true,
|
||||
"components_used": [
|
||||
"PointsDisplay",
|
||||
"TaskCard",
|
||||
"DailyCheckinButton",
|
||||
"BadgeCard",
|
||||
"Navbar"
|
||||
],
|
||||
"features": [
|
||||
"Points balance display",
|
||||
"Daily check-in button with streak",
|
||||
"Quick task overview (3-5 featured tasks)",
|
||||
"Recent badges earned",
|
||||
"Navigation to other sections"
|
||||
],
|
||||
"path": "/"
|
||||
}
|
||||
},
|
||||
"related": {
|
||||
"models": [],
|
||||
"apis": [],
|
||||
"components": []
|
||||
},
|
||||
"dependencies": {
|
||||
"entity_ids": [],
|
||||
"definitions": []
|
||||
},
|
||||
"files": {
|
||||
"to_create": [
|
||||
"app//page.tsx"
|
||||
],
|
||||
"reference": []
|
||||
},
|
||||
"acceptance": [
|
||||
{
|
||||
"criterion": "Page renders at /",
|
||||
"verification": "Navigate to /"
|
||||
},
|
||||
{
|
||||
"criterion": "Data fetching works",
|
||||
"verification": "Check network tab"
|
||||
},
|
||||
{
|
||||
"criterion": "Components render correctly",
|
||||
"verification": "Visual inspection"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
|
@ -0,0 +1,58 @@
|
|||
{
|
||||
"task_id": "task_create_page_leaderboard",
|
||||
"entity_id": "page_leaderboard",
|
||||
"generated_at": "2025-12-18T01:57:52.723944",
|
||||
"workflow_version": "v001",
|
||||
"target": {
|
||||
"type": "page",
|
||||
"definition": {
|
||||
"id": "page_leaderboard",
|
||||
"name": "Leaderboard Page",
|
||||
"description": "Rankings of top users",
|
||||
"file_path": "app/leaderboard/page.tsx",
|
||||
"status": "PENDING",
|
||||
"auth_required": true,
|
||||
"components_used": [
|
||||
"LeaderboardTable",
|
||||
"Navbar"
|
||||
],
|
||||
"features": [
|
||||
"Top 100 users by points",
|
||||
"User rank display",
|
||||
"Current user highlight",
|
||||
"Points totals",
|
||||
"Update in real-time"
|
||||
],
|
||||
"path": "/leaderboard"
|
||||
}
|
||||
},
|
||||
"related": {
|
||||
"models": [],
|
||||
"apis": [],
|
||||
"components": []
|
||||
},
|
||||
"dependencies": {
|
||||
"entity_ids": [],
|
||||
"definitions": []
|
||||
},
|
||||
"files": {
|
||||
"to_create": [
|
||||
"app/leaderboard/page.tsx"
|
||||
],
|
||||
"reference": []
|
||||
},
|
||||
"acceptance": [
|
||||
{
|
||||
"criterion": "Page renders at /leaderboard",
|
||||
"verification": "Navigate to /leaderboard"
|
||||
},
|
||||
{
|
||||
"criterion": "Data fetching works",
|
||||
"verification": "Check network tab"
|
||||
},
|
||||
{
|
||||
"criterion": "Components render correctly",
|
||||
"verification": "Visual inspection"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
|
@ -0,0 +1,56 @@
|
|||
{
|
||||
"task_id": "task_create_page_login",
|
||||
"entity_id": "page_login",
|
||||
"generated_at": "2025-12-18T01:57:52.723504",
|
||||
"workflow_version": "v001",
|
||||
"target": {
|
||||
"type": "page",
|
||||
"definition": {
|
||||
"id": "page_login",
|
||||
"name": "Login Page",
|
||||
"description": "User login page",
|
||||
"file_path": "app/login/page.tsx",
|
||||
"status": "PENDING",
|
||||
"components_used": [
|
||||
"AuthForm"
|
||||
],
|
||||
"features": [
|
||||
"Email/password login form",
|
||||
"Link to register page",
|
||||
"Form validation",
|
||||
"Error display",
|
||||
"Redirect to dashboard on success"
|
||||
],
|
||||
"path": "/login"
|
||||
}
|
||||
},
|
||||
"related": {
|
||||
"models": [],
|
||||
"apis": [],
|
||||
"components": []
|
||||
},
|
||||
"dependencies": {
|
||||
"entity_ids": [],
|
||||
"definitions": []
|
||||
},
|
||||
"files": {
|
||||
"to_create": [
|
||||
"app/login/page.tsx"
|
||||
],
|
||||
"reference": []
|
||||
},
|
||||
"acceptance": [
|
||||
{
|
||||
"criterion": "Page renders at /login",
|
||||
"verification": "Navigate to /login"
|
||||
},
|
||||
{
|
||||
"criterion": "Data fetching works",
|
||||
"verification": "Check network tab"
|
||||
},
|
||||
{
|
||||
"criterion": "Components render correctly",
|
||||
"verification": "Visual inspection"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
|
@ -0,0 +1,60 @@
|
|||
{
|
||||
"task_id": "task_create_page_profile",
|
||||
"entity_id": "page_profile",
|
||||
"generated_at": "2025-12-18T01:57:52.723874",
|
||||
"workflow_version": "v001",
|
||||
"target": {
|
||||
"type": "page",
|
||||
"definition": {
|
||||
"id": "page_profile",
|
||||
"name": "Profile Page",
|
||||
"description": "User profile with points history",
|
||||
"file_path": "app/profile/page.tsx",
|
||||
"status": "PENDING",
|
||||
"auth_required": true,
|
||||
"components_used": [
|
||||
"PointsDisplay",
|
||||
"TransactionHistory",
|
||||
"BadgeCard",
|
||||
"Navbar"
|
||||
],
|
||||
"features": [
|
||||
"User info display",
|
||||
"Total points balance",
|
||||
"Points transaction history",
|
||||
"Earned badges display",
|
||||
"Account statistics"
|
||||
],
|
||||
"path": "/profile"
|
||||
}
|
||||
},
|
||||
"related": {
|
||||
"models": [],
|
||||
"apis": [],
|
||||
"components": []
|
||||
},
|
||||
"dependencies": {
|
||||
"entity_ids": [],
|
||||
"definitions": []
|
||||
},
|
||||
"files": {
|
||||
"to_create": [
|
||||
"app/profile/page.tsx"
|
||||
],
|
||||
"reference": []
|
||||
},
|
||||
"acceptance": [
|
||||
{
|
||||
"criterion": "Page renders at /profile",
|
||||
"verification": "Navigate to /profile"
|
||||
},
|
||||
{
|
||||
"criterion": "Data fetching works",
|
||||
"verification": "Check network tab"
|
||||
},
|
||||
{
|
||||
"criterion": "Components render correctly",
|
||||
"verification": "Visual inspection"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
|
@ -0,0 +1,58 @@
|
|||
{
|
||||
"task_id": "task_create_page_quiz",
|
||||
"entity_id": "page_quiz",
|
||||
"generated_at": "2025-12-18T01:57:52.723794",
|
||||
"workflow_version": "v001",
|
||||
"target": {
|
||||
"type": "page",
|
||||
"definition": {
|
||||
"id": "page_quiz",
|
||||
"name": "Quiz Page",
|
||||
"description": "Quiz interface for learning tasks",
|
||||
"file_path": "app/quiz/[id]/page.tsx",
|
||||
"status": "PENDING",
|
||||
"auth_required": true,
|
||||
"components_used": [
|
||||
"QuizQuestion",
|
||||
"Navbar"
|
||||
],
|
||||
"features": [
|
||||
"Display quiz questions one by one",
|
||||
"Multiple choice answers",
|
||||
"Submit button",
|
||||
"Score display after completion",
|
||||
"Points earned display"
|
||||
],
|
||||
"path": "/quiz/[id]"
|
||||
}
|
||||
},
|
||||
"related": {
|
||||
"models": [],
|
||||
"apis": [],
|
||||
"components": []
|
||||
},
|
||||
"dependencies": {
|
||||
"entity_ids": [],
|
||||
"definitions": []
|
||||
},
|
||||
"files": {
|
||||
"to_create": [
|
||||
"app/quiz/[id]/page.tsx"
|
||||
],
|
||||
"reference": []
|
||||
},
|
||||
"acceptance": [
|
||||
{
|
||||
"criterion": "Page renders at /quiz/[id]",
|
||||
"verification": "Navigate to /quiz/[id]"
|
||||
},
|
||||
{
|
||||
"criterion": "Data fetching works",
|
||||
"verification": "Check network tab"
|
||||
},
|
||||
{
|
||||
"criterion": "Components render correctly",
|
||||
"verification": "Visual inspection"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
|
@ -0,0 +1,57 @@
|
|||
{
|
||||
"task_id": "task_create_page_referral",
|
||||
"entity_id": "page_referral",
|
||||
"generated_at": "2025-12-18T01:57:52.724017",
|
||||
"workflow_version": "v001",
|
||||
"target": {
|
||||
"type": "page",
|
||||
"definition": {
|
||||
"id": "page_referral",
|
||||
"name": "Referral Page",
|
||||
"description": "Referral code sharing",
|
||||
"file_path": "app/referral/page.tsx",
|
||||
"status": "PENDING",
|
||||
"auth_required": true,
|
||||
"components_used": [
|
||||
"Navbar"
|
||||
],
|
||||
"features": [
|
||||
"Generate referral code",
|
||||
"Display shareable link",
|
||||
"Copy to clipboard button",
|
||||
"Show referral statistics",
|
||||
"Bonus points display"
|
||||
],
|
||||
"path": "/referral"
|
||||
}
|
||||
},
|
||||
"related": {
|
||||
"models": [],
|
||||
"apis": [],
|
||||
"components": []
|
||||
},
|
||||
"dependencies": {
|
||||
"entity_ids": [],
|
||||
"definitions": []
|
||||
},
|
||||
"files": {
|
||||
"to_create": [
|
||||
"app/referral/page.tsx"
|
||||
],
|
||||
"reference": []
|
||||
},
|
||||
"acceptance": [
|
||||
{
|
||||
"criterion": "Page renders at /referral",
|
||||
"verification": "Navigate to /referral"
|
||||
},
|
||||
{
|
||||
"criterion": "Data fetching works",
|
||||
"verification": "Check network tab"
|
||||
},
|
||||
{
|
||||
"criterion": "Components render correctly",
|
||||
"verification": "Visual inspection"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
|
@ -0,0 +1,56 @@
|
|||
{
|
||||
"task_id": "task_create_page_register",
|
||||
"entity_id": "page_register",
|
||||
"generated_at": "2025-12-18T01:57:52.723574",
|
||||
"workflow_version": "v001",
|
||||
"target": {
|
||||
"type": "page",
|
||||
"definition": {
|
||||
"id": "page_register",
|
||||
"name": "Register Page",
|
||||
"description": "User registration page",
|
||||
"file_path": "app/register/page.tsx",
|
||||
"status": "PENDING",
|
||||
"components_used": [
|
||||
"AuthForm"
|
||||
],
|
||||
"features": [
|
||||
"Registration form with email, password, name",
|
||||
"Link to login page",
|
||||
"Form validation (password min 8 chars)",
|
||||
"Error display",
|
||||
"Redirect to dashboard on success"
|
||||
],
|
||||
"path": "/register"
|
||||
}
|
||||
},
|
||||
"related": {
|
||||
"models": [],
|
||||
"apis": [],
|
||||
"components": []
|
||||
},
|
||||
"dependencies": {
|
||||
"entity_ids": [],
|
||||
"definitions": []
|
||||
},
|
||||
"files": {
|
||||
"to_create": [
|
||||
"app/register/page.tsx"
|
||||
],
|
||||
"reference": []
|
||||
},
|
||||
"acceptance": [
|
||||
{
|
||||
"criterion": "Page renders at /register",
|
||||
"verification": "Navigate to /register"
|
||||
},
|
||||
{
|
||||
"criterion": "Data fetching works",
|
||||
"verification": "Check network tab"
|
||||
},
|
||||
{
|
||||
"criterion": "Components render correctly",
|
||||
"verification": "Visual inspection"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
|
@ -0,0 +1,59 @@
|
|||
{
|
||||
"task_id": "task_create_page_tasks",
|
||||
"entity_id": "page_tasks",
|
||||
"generated_at": "2025-12-18T01:57:52.723718",
|
||||
"workflow_version": "v001",
|
||||
"target": {
|
||||
"type": "page",
|
||||
"definition": {
|
||||
"id": "page_tasks",
|
||||
"name": "Tasks Page",
|
||||
"description": "List of all available tasks",
|
||||
"file_path": "app/tasks/page.tsx",
|
||||
"status": "PENDING",
|
||||
"auth_required": true,
|
||||
"components_used": [
|
||||
"TaskList",
|
||||
"TaskCard",
|
||||
"Navbar"
|
||||
],
|
||||
"features": [
|
||||
"List all available tasks",
|
||||
"Filter by task type",
|
||||
"Show completion status",
|
||||
"Click to complete or view task",
|
||||
"Points reward display"
|
||||
],
|
||||
"path": "/tasks"
|
||||
}
|
||||
},
|
||||
"related": {
|
||||
"models": [],
|
||||
"apis": [],
|
||||
"components": []
|
||||
},
|
||||
"dependencies": {
|
||||
"entity_ids": [],
|
||||
"definitions": []
|
||||
},
|
||||
"files": {
|
||||
"to_create": [
|
||||
"app/tasks/page.tsx"
|
||||
],
|
||||
"reference": []
|
||||
},
|
||||
"acceptance": [
|
||||
{
|
||||
"criterion": "Page renders at /tasks",
|
||||
"verification": "Navigate to /tasks"
|
||||
},
|
||||
{
|
||||
"criterion": "Data fetching works",
|
||||
"verification": "Check network tab"
|
||||
},
|
||||
{
|
||||
"criterion": "Components render correctly",
|
||||
"verification": "Visual inspection"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
|
@ -0,0 +1,628 @@
|
|||
{
|
||||
"dependency_graph": {
|
||||
"design_version": 1,
|
||||
"workflow_version": "v001",
|
||||
"generated_at": "2025-12-18T01:57:52.721168",
|
||||
"generator": "validate_design.py",
|
||||
"stats": {
|
||||
"total_entities": 40,
|
||||
"total_layers": 1,
|
||||
"max_parallelism": 40,
|
||||
"critical_path_length": 1
|
||||
}
|
||||
},
|
||||
"layers": [
|
||||
{
|
||||
"layer": 1,
|
||||
"name": "Data Layer",
|
||||
"description": "Database models - no external dependencies",
|
||||
"items": [
|
||||
{
|
||||
"id": "api_auth_login",
|
||||
"type": "api",
|
||||
"name": "api_auth_login",
|
||||
"depends_on": [],
|
||||
"task_id": "task_create_api_auth_login",
|
||||
"agent": "backend",
|
||||
"complexity": "medium"
|
||||
},
|
||||
{
|
||||
"id": "api_auth_me",
|
||||
"type": "api",
|
||||
"name": "api_auth_me",
|
||||
"depends_on": [],
|
||||
"task_id": "task_create_api_auth_me",
|
||||
"agent": "backend",
|
||||
"complexity": "medium"
|
||||
},
|
||||
{
|
||||
"id": "api_auth_register",
|
||||
"type": "api",
|
||||
"name": "api_auth_register",
|
||||
"depends_on": [],
|
||||
"task_id": "task_create_api_auth_register",
|
||||
"agent": "backend",
|
||||
"complexity": "medium"
|
||||
},
|
||||
{
|
||||
"id": "api_leaderboard",
|
||||
"type": "api",
|
||||
"name": "api_leaderboard",
|
||||
"depends_on": [],
|
||||
"task_id": "task_create_api_leaderboard",
|
||||
"agent": "backend",
|
||||
"complexity": "medium"
|
||||
},
|
||||
{
|
||||
"id": "api_quizzes_get",
|
||||
"type": "api",
|
||||
"name": "api_quizzes_get",
|
||||
"depends_on": [],
|
||||
"task_id": "task_create_api_quizzes_get",
|
||||
"agent": "backend",
|
||||
"complexity": "medium"
|
||||
},
|
||||
{
|
||||
"id": "api_quizzes_submit",
|
||||
"type": "api",
|
||||
"name": "api_quizzes_submit",
|
||||
"depends_on": [],
|
||||
"task_id": "task_create_api_quizzes_submit",
|
||||
"agent": "backend",
|
||||
"complexity": "medium"
|
||||
},
|
||||
{
|
||||
"id": "api_referrals_claim",
|
||||
"type": "api",
|
||||
"name": "api_referrals_claim",
|
||||
"depends_on": [],
|
||||
"task_id": "task_create_api_referrals_claim",
|
||||
"agent": "backend",
|
||||
"complexity": "medium"
|
||||
},
|
||||
{
|
||||
"id": "api_referrals_create",
|
||||
"type": "api",
|
||||
"name": "api_referrals_create",
|
||||
"depends_on": [],
|
||||
"task_id": "task_create_api_referrals_create",
|
||||
"agent": "backend",
|
||||
"complexity": "medium"
|
||||
},
|
||||
{
|
||||
"id": "api_tasks_checkin",
|
||||
"type": "api",
|
||||
"name": "api_tasks_checkin",
|
||||
"depends_on": [],
|
||||
"task_id": "task_create_api_tasks_checkin",
|
||||
"agent": "backend",
|
||||
"complexity": "medium"
|
||||
},
|
||||
{
|
||||
"id": "api_tasks_complete",
|
||||
"type": "api",
|
||||
"name": "api_tasks_complete",
|
||||
"depends_on": [],
|
||||
"task_id": "task_create_api_tasks_complete",
|
||||
"agent": "backend",
|
||||
"complexity": "medium"
|
||||
},
|
||||
{
|
||||
"id": "api_tasks_list",
|
||||
"type": "api",
|
||||
"name": "api_tasks_list",
|
||||
"depends_on": [],
|
||||
"task_id": "task_create_api_tasks_list",
|
||||
"agent": "backend",
|
||||
"complexity": "medium"
|
||||
},
|
||||
{
|
||||
"id": "api_users_badges",
|
||||
"type": "api",
|
||||
"name": "api_users_badges",
|
||||
"depends_on": [],
|
||||
"task_id": "task_create_api_users_badges",
|
||||
"agent": "backend",
|
||||
"complexity": "medium"
|
||||
},
|
||||
{
|
||||
"id": "api_users_points",
|
||||
"type": "api",
|
||||
"name": "api_users_points",
|
||||
"depends_on": [],
|
||||
"task_id": "task_create_api_users_points",
|
||||
"agent": "backend",
|
||||
"complexity": "medium"
|
||||
},
|
||||
{
|
||||
"id": "component_auth_form",
|
||||
"type": "component",
|
||||
"name": "AuthForm",
|
||||
"depends_on": [],
|
||||
"task_id": "task_create_component_auth_form",
|
||||
"agent": "frontend",
|
||||
"complexity": "medium"
|
||||
},
|
||||
{
|
||||
"id": "component_badge_card",
|
||||
"type": "component",
|
||||
"name": "BadgeCard",
|
||||
"depends_on": [],
|
||||
"task_id": "task_create_component_badge_card",
|
||||
"agent": "frontend",
|
||||
"complexity": "medium"
|
||||
},
|
||||
{
|
||||
"id": "component_daily_checkin_button",
|
||||
"type": "component",
|
||||
"name": "DailyCheckinButton",
|
||||
"depends_on": [],
|
||||
"task_id": "task_create_component_daily_checkin_button",
|
||||
"agent": "frontend",
|
||||
"complexity": "medium"
|
||||
},
|
||||
{
|
||||
"id": "component_dark_theme_layout",
|
||||
"type": "component",
|
||||
"name": "DarkThemeLayout",
|
||||
"depends_on": [],
|
||||
"task_id": "task_create_component_dark_theme_layout",
|
||||
"agent": "frontend",
|
||||
"complexity": "medium"
|
||||
},
|
||||
{
|
||||
"id": "component_leaderboard_table",
|
||||
"type": "component",
|
||||
"name": "LeaderboardTable",
|
||||
"depends_on": [],
|
||||
"task_id": "task_create_component_leaderboard_table",
|
||||
"agent": "frontend",
|
||||
"complexity": "medium"
|
||||
},
|
||||
{
|
||||
"id": "component_navbar",
|
||||
"type": "component",
|
||||
"name": "Navbar",
|
||||
"depends_on": [],
|
||||
"task_id": "task_create_component_navbar",
|
||||
"agent": "frontend",
|
||||
"complexity": "medium"
|
||||
},
|
||||
{
|
||||
"id": "component_points_display",
|
||||
"type": "component",
|
||||
"name": "PointsDisplay",
|
||||
"depends_on": [],
|
||||
"task_id": "task_create_component_points_display",
|
||||
"agent": "frontend",
|
||||
"complexity": "medium"
|
||||
},
|
||||
{
|
||||
"id": "component_quiz_question",
|
||||
"type": "component",
|
||||
"name": "QuizQuestion",
|
||||
"depends_on": [],
|
||||
"task_id": "task_create_component_quiz_question",
|
||||
"agent": "frontend",
|
||||
"complexity": "medium"
|
||||
},
|
||||
{
|
||||
"id": "component_task_card",
|
||||
"type": "component",
|
||||
"name": "TaskCard",
|
||||
"depends_on": [],
|
||||
"task_id": "task_create_component_task_card",
|
||||
"agent": "frontend",
|
||||
"complexity": "medium"
|
||||
},
|
||||
{
|
||||
"id": "component_task_list",
|
||||
"type": "component",
|
||||
"name": "TaskList",
|
||||
"depends_on": [],
|
||||
"task_id": "task_create_component_task_list",
|
||||
"agent": "frontend",
|
||||
"complexity": "medium"
|
||||
},
|
||||
{
|
||||
"id": "component_transaction_history",
|
||||
"type": "component",
|
||||
"name": "TransactionHistory",
|
||||
"depends_on": [],
|
||||
"task_id": "task_create_component_transaction_history",
|
||||
"agent": "frontend",
|
||||
"complexity": "medium"
|
||||
},
|
||||
{
|
||||
"id": "model_badge",
|
||||
"type": "model",
|
||||
"name": "Badge",
|
||||
"depends_on": [],
|
||||
"task_id": "task_create_model_badge",
|
||||
"agent": "backend",
|
||||
"complexity": "medium"
|
||||
},
|
||||
{
|
||||
"id": "model_points",
|
||||
"type": "model",
|
||||
"name": "Points",
|
||||
"depends_on": [],
|
||||
"task_id": "task_create_model_points",
|
||||
"agent": "backend",
|
||||
"complexity": "medium"
|
||||
},
|
||||
{
|
||||
"id": "model_quiz",
|
||||
"type": "model",
|
||||
"name": "Quiz",
|
||||
"depends_on": [],
|
||||
"task_id": "task_create_model_quiz",
|
||||
"agent": "backend",
|
||||
"complexity": "medium"
|
||||
},
|
||||
{
|
||||
"id": "model_referral",
|
||||
"type": "model",
|
||||
"name": "Referral",
|
||||
"depends_on": [],
|
||||
"task_id": "task_create_model_referral",
|
||||
"agent": "backend",
|
||||
"complexity": "medium"
|
||||
},
|
||||
{
|
||||
"id": "model_task",
|
||||
"type": "model",
|
||||
"name": "Task",
|
||||
"depends_on": [],
|
||||
"task_id": "task_create_model_task",
|
||||
"agent": "backend",
|
||||
"complexity": "medium"
|
||||
},
|
||||
{
|
||||
"id": "model_user",
|
||||
"type": "model",
|
||||
"name": "User",
|
||||
"depends_on": [],
|
||||
"task_id": "task_create_model_user",
|
||||
"agent": "backend",
|
||||
"complexity": "medium"
|
||||
},
|
||||
{
|
||||
"id": "model_user_badge",
|
||||
"type": "model",
|
||||
"name": "UserBadge",
|
||||
"depends_on": [],
|
||||
"task_id": "task_create_model_user_badge",
|
||||
"agent": "backend",
|
||||
"complexity": "medium"
|
||||
},
|
||||
{
|
||||
"id": "model_user_task",
|
||||
"type": "model",
|
||||
"name": "UserTask",
|
||||
"depends_on": [],
|
||||
"task_id": "task_create_model_user_task",
|
||||
"agent": "backend",
|
||||
"complexity": "medium"
|
||||
},
|
||||
{
|
||||
"id": "page_dashboard",
|
||||
"type": "page",
|
||||
"name": "Dashboard",
|
||||
"depends_on": [],
|
||||
"task_id": "task_create_page_dashboard",
|
||||
"agent": "frontend",
|
||||
"complexity": "medium"
|
||||
},
|
||||
{
|
||||
"id": "page_leaderboard",
|
||||
"type": "page",
|
||||
"name": "Leaderboard Page",
|
||||
"depends_on": [],
|
||||
"task_id": "task_create_page_leaderboard",
|
||||
"agent": "frontend",
|
||||
"complexity": "medium"
|
||||
},
|
||||
{
|
||||
"id": "page_login",
|
||||
"type": "page",
|
||||
"name": "Login Page",
|
||||
"depends_on": [],
|
||||
"task_id": "task_create_page_login",
|
||||
"agent": "frontend",
|
||||
"complexity": "medium"
|
||||
},
|
||||
{
|
||||
"id": "page_profile",
|
||||
"type": "page",
|
||||
"name": "Profile Page",
|
||||
"depends_on": [],
|
||||
"task_id": "task_create_page_profile",
|
||||
"agent": "frontend",
|
||||
"complexity": "medium"
|
||||
},
|
||||
{
|
||||
"id": "page_quiz",
|
||||
"type": "page",
|
||||
"name": "Quiz Page",
|
||||
"depends_on": [],
|
||||
"task_id": "task_create_page_quiz",
|
||||
"agent": "frontend",
|
||||
"complexity": "medium"
|
||||
},
|
||||
{
|
||||
"id": "page_referral",
|
||||
"type": "page",
|
||||
"name": "Referral Page",
|
||||
"depends_on": [],
|
||||
"task_id": "task_create_page_referral",
|
||||
"agent": "frontend",
|
||||
"complexity": "medium"
|
||||
},
|
||||
{
|
||||
"id": "page_register",
|
||||
"type": "page",
|
||||
"name": "Register Page",
|
||||
"depends_on": [],
|
||||
"task_id": "task_create_page_register",
|
||||
"agent": "frontend",
|
||||
"complexity": "medium"
|
||||
},
|
||||
{
|
||||
"id": "page_tasks",
|
||||
"type": "page",
|
||||
"name": "Tasks Page",
|
||||
"depends_on": [],
|
||||
"task_id": "task_create_page_tasks",
|
||||
"agent": "frontend",
|
||||
"complexity": "medium"
|
||||
}
|
||||
],
|
||||
"requires_layers": [],
|
||||
"parallel_count": 40
|
||||
}
|
||||
],
|
||||
"dependency_map": {
|
||||
"model_user": {
|
||||
"type": "model",
|
||||
"layer": 1,
|
||||
"depends_on": [],
|
||||
"depended_by": []
|
||||
},
|
||||
"model_points": {
|
||||
"type": "model",
|
||||
"layer": 1,
|
||||
"depends_on": [],
|
||||
"depended_by": []
|
||||
},
|
||||
"model_task": {
|
||||
"type": "model",
|
||||
"layer": 1,
|
||||
"depends_on": [],
|
||||
"depended_by": []
|
||||
},
|
||||
"model_user_task": {
|
||||
"type": "model",
|
||||
"layer": 1,
|
||||
"depends_on": [],
|
||||
"depended_by": []
|
||||
},
|
||||
"model_badge": {
|
||||
"type": "model",
|
||||
"layer": 1,
|
||||
"depends_on": [],
|
||||
"depended_by": []
|
||||
},
|
||||
"model_user_badge": {
|
||||
"type": "model",
|
||||
"layer": 1,
|
||||
"depends_on": [],
|
||||
"depended_by": []
|
||||
},
|
||||
"model_quiz": {
|
||||
"type": "model",
|
||||
"layer": 1,
|
||||
"depends_on": [],
|
||||
"depended_by": []
|
||||
},
|
||||
"model_referral": {
|
||||
"type": "model",
|
||||
"layer": 1,
|
||||
"depends_on": [],
|
||||
"depended_by": []
|
||||
},
|
||||
"api_auth_register": {
|
||||
"type": "api",
|
||||
"layer": 1,
|
||||
"depends_on": [],
|
||||
"depended_by": []
|
||||
},
|
||||
"api_auth_login": {
|
||||
"type": "api",
|
||||
"layer": 1,
|
||||
"depends_on": [],
|
||||
"depended_by": []
|
||||
},
|
||||
"api_auth_me": {
|
||||
"type": "api",
|
||||
"layer": 1,
|
||||
"depends_on": [],
|
||||
"depended_by": []
|
||||
},
|
||||
"api_users_points": {
|
||||
"type": "api",
|
||||
"layer": 1,
|
||||
"depends_on": [],
|
||||
"depended_by": []
|
||||
},
|
||||
"api_users_badges": {
|
||||
"type": "api",
|
||||
"layer": 1,
|
||||
"depends_on": [],
|
||||
"depended_by": []
|
||||
},
|
||||
"api_tasks_list": {
|
||||
"type": "api",
|
||||
"layer": 1,
|
||||
"depends_on": [],
|
||||
"depended_by": []
|
||||
},
|
||||
"api_tasks_checkin": {
|
||||
"type": "api",
|
||||
"layer": 1,
|
||||
"depends_on": [],
|
||||
"depended_by": []
|
||||
},
|
||||
"api_tasks_complete": {
|
||||
"type": "api",
|
||||
"layer": 1,
|
||||
"depends_on": [],
|
||||
"depended_by": []
|
||||
},
|
||||
"api_quizzes_get": {
|
||||
"type": "api",
|
||||
"layer": 1,
|
||||
"depends_on": [],
|
||||
"depended_by": []
|
||||
},
|
||||
"api_quizzes_submit": {
|
||||
"type": "api",
|
||||
"layer": 1,
|
||||
"depends_on": [],
|
||||
"depended_by": []
|
||||
},
|
||||
"api_leaderboard": {
|
||||
"type": "api",
|
||||
"layer": 1,
|
||||
"depends_on": [],
|
||||
"depended_by": []
|
||||
},
|
||||
"api_referrals_create": {
|
||||
"type": "api",
|
||||
"layer": 1,
|
||||
"depends_on": [],
|
||||
"depended_by": []
|
||||
},
|
||||
"api_referrals_claim": {
|
||||
"type": "api",
|
||||
"layer": 1,
|
||||
"depends_on": [],
|
||||
"depended_by": []
|
||||
},
|
||||
"page_login": {
|
||||
"type": "page",
|
||||
"layer": 1,
|
||||
"depends_on": [],
|
||||
"depended_by": []
|
||||
},
|
||||
"page_register": {
|
||||
"type": "page",
|
||||
"layer": 1,
|
||||
"depends_on": [],
|
||||
"depended_by": []
|
||||
},
|
||||
"page_dashboard": {
|
||||
"type": "page",
|
||||
"layer": 1,
|
||||
"depends_on": [],
|
||||
"depended_by": []
|
||||
},
|
||||
"page_tasks": {
|
||||
"type": "page",
|
||||
"layer": 1,
|
||||
"depends_on": [],
|
||||
"depended_by": []
|
||||
},
|
||||
"page_quiz": {
|
||||
"type": "page",
|
||||
"layer": 1,
|
||||
"depends_on": [],
|
||||
"depended_by": []
|
||||
},
|
||||
"page_profile": {
|
||||
"type": "page",
|
||||
"layer": 1,
|
||||
"depends_on": [],
|
||||
"depended_by": []
|
||||
},
|
||||
"page_leaderboard": {
|
||||
"type": "page",
|
||||
"layer": 1,
|
||||
"depends_on": [],
|
||||
"depended_by": []
|
||||
},
|
||||
"page_referral": {
|
||||
"type": "page",
|
||||
"layer": 1,
|
||||
"depends_on": [],
|
||||
"depended_by": []
|
||||
},
|
||||
"component_auth_form": {
|
||||
"type": "component",
|
||||
"layer": 1,
|
||||
"depends_on": [],
|
||||
"depended_by": []
|
||||
},
|
||||
"component_points_display": {
|
||||
"type": "component",
|
||||
"layer": 1,
|
||||
"depends_on": [],
|
||||
"depended_by": []
|
||||
},
|
||||
"component_task_card": {
|
||||
"type": "component",
|
||||
"layer": 1,
|
||||
"depends_on": [],
|
||||
"depended_by": []
|
||||
},
|
||||
"component_task_list": {
|
||||
"type": "component",
|
||||
"layer": 1,
|
||||
"depends_on": [],
|
||||
"depended_by": []
|
||||
},
|
||||
"component_quiz_question": {
|
||||
"type": "component",
|
||||
"layer": 1,
|
||||
"depends_on": [],
|
||||
"depended_by": []
|
||||
},
|
||||
"component_badge_card": {
|
||||
"type": "component",
|
||||
"layer": 1,
|
||||
"depends_on": [],
|
||||
"depended_by": []
|
||||
},
|
||||
"component_leaderboard_table": {
|
||||
"type": "component",
|
||||
"layer": 1,
|
||||
"depends_on": [],
|
||||
"depended_by": []
|
||||
},
|
||||
"component_daily_checkin_button": {
|
||||
"type": "component",
|
||||
"layer": 1,
|
||||
"depends_on": [],
|
||||
"depended_by": []
|
||||
},
|
||||
"component_transaction_history": {
|
||||
"type": "component",
|
||||
"layer": 1,
|
||||
"depends_on": [],
|
||||
"depended_by": []
|
||||
},
|
||||
"component_navbar": {
|
||||
"type": "component",
|
||||
"layer": 1,
|
||||
"depends_on": [],
|
||||
"depended_by": []
|
||||
},
|
||||
"component_dark_theme_layout": {
|
||||
"type": "component",
|
||||
"layer": 1,
|
||||
"depends_on": [],
|
||||
"depended_by": []
|
||||
}
|
||||
},
|
||||
"task_map": []
|
||||
}
|
||||
File diff suppressed because it is too large
Load Diff
|
|
@ -0,0 +1,156 @@
|
|||
{
|
||||
"version": "v001",
|
||||
"current_phase": "INITIALIZING",
|
||||
"created_at": "2025-12-18T02:39:33.559779",
|
||||
"updated_at": "2025-12-18T02:39:50.747171",
|
||||
"phases": {
|
||||
"INITIALIZING": {
|
||||
"status": "completed",
|
||||
"entered_at": "2025-12-18T02:39:33.559790",
|
||||
"completed_at": "2025-12-18T02:39:50.747165",
|
||||
"checkpoints": {
|
||||
"manifest_exists": {
|
||||
"status": "passed",
|
||||
"at": "2025-12-18T02:39:33.775898",
|
||||
"data": {}
|
||||
},
|
||||
"version_created": {
|
||||
"status": "passed",
|
||||
"at": "2025-12-18T02:39:50.713177",
|
||||
"data": {}
|
||||
}
|
||||
}
|
||||
},
|
||||
"DESIGNING": {
|
||||
"status": "not_started",
|
||||
"entered_at": null,
|
||||
"completed_at": null,
|
||||
"checkpoints": {
|
||||
"design_document_created": {
|
||||
"status": "pending",
|
||||
"at": null,
|
||||
"data": {}
|
||||
},
|
||||
"design_validated": {
|
||||
"status": "pending",
|
||||
"at": null,
|
||||
"data": {}
|
||||
},
|
||||
"tasks_generated": {
|
||||
"status": "pending",
|
||||
"at": null,
|
||||
"data": {}
|
||||
}
|
||||
}
|
||||
},
|
||||
"AWAITING_DESIGN_APPROVAL": {
|
||||
"status": "not_started",
|
||||
"entered_at": null,
|
||||
"completed_at": null,
|
||||
"checkpoints": {
|
||||
"design_approved": {
|
||||
"status": "pending",
|
||||
"at": null,
|
||||
"data": {}
|
||||
}
|
||||
}
|
||||
},
|
||||
"IMPLEMENTING": {
|
||||
"status": "not_started",
|
||||
"entered_at": null,
|
||||
"completed_at": null,
|
||||
"checkpoints": {
|
||||
"all_layers_complete": {
|
||||
"status": "pending",
|
||||
"at": null,
|
||||
"data": {}
|
||||
},
|
||||
"build_passes": {
|
||||
"status": "pending",
|
||||
"at": null,
|
||||
"data": {}
|
||||
}
|
||||
}
|
||||
},
|
||||
"REVIEWING": {
|
||||
"status": "not_started",
|
||||
"entered_at": null,
|
||||
"completed_at": null,
|
||||
"checkpoints": {
|
||||
"review_script_run": {
|
||||
"status": "pending",
|
||||
"at": null,
|
||||
"data": {}
|
||||
},
|
||||
"all_files_verified": {
|
||||
"status": "pending",
|
||||
"at": null,
|
||||
"data": {}
|
||||
},
|
||||
"review_passed": {
|
||||
"status": "pending",
|
||||
"at": null,
|
||||
"data": {}
|
||||
}
|
||||
}
|
||||
},
|
||||
"SECURITY_REVIEW": {
|
||||
"status": "not_started",
|
||||
"entered_at": null,
|
||||
"completed_at": null,
|
||||
"checkpoints": {
|
||||
"security_scan_run": {
|
||||
"status": "pending",
|
||||
"at": null,
|
||||
"data": {}
|
||||
},
|
||||
"api_contract_validated": {
|
||||
"status": "pending",
|
||||
"at": null,
|
||||
"data": {}
|
||||
},
|
||||
"security_passed": {
|
||||
"status": "pending",
|
||||
"at": null,
|
||||
"data": {}
|
||||
}
|
||||
}
|
||||
},
|
||||
"AWAITING_IMPL_APPROVAL": {
|
||||
"status": "not_started",
|
||||
"entered_at": null,
|
||||
"completed_at": null,
|
||||
"checkpoints": {
|
||||
"implementation_approved": {
|
||||
"status": "pending",
|
||||
"at": null,
|
||||
"data": {}
|
||||
}
|
||||
}
|
||||
},
|
||||
"COMPLETING": {
|
||||
"status": "not_started",
|
||||
"entered_at": null,
|
||||
"completed_at": null,
|
||||
"checkpoints": {
|
||||
"tasks_marked_complete": {
|
||||
"status": "pending",
|
||||
"at": null,
|
||||
"data": {}
|
||||
},
|
||||
"version_finalized": {
|
||||
"status": "pending",
|
||||
"at": null,
|
||||
"data": {}
|
||||
}
|
||||
}
|
||||
},
|
||||
"COMPLETED": {
|
||||
"status": "not_started",
|
||||
"entered_at": null,
|
||||
"completed_at": null,
|
||||
"checkpoints": {}
|
||||
}
|
||||
},
|
||||
"fix_loops": []
|
||||
}
|
||||
|
|
@ -0,0 +1,77 @@
|
|||
[
|
||||
{
|
||||
"path": "pp/page.tsx",
|
||||
"action": "modified",
|
||||
"summary": ""
|
||||
},
|
||||
{
|
||||
"path": ".claude/",
|
||||
"action": "untracked",
|
||||
"summary": ""
|
||||
},
|
||||
{
|
||||
"path": ".eureka-active-session",
|
||||
"action": "untracked",
|
||||
"summary": ""
|
||||
},
|
||||
{
|
||||
"path": ".mcp.json",
|
||||
"action": "untracked",
|
||||
"summary": ""
|
||||
},
|
||||
{
|
||||
"path": ".workflow/",
|
||||
"action": "untracked",
|
||||
"summary": ""
|
||||
},
|
||||
{
|
||||
"path": "CLAUDE.md",
|
||||
"action": "untracked",
|
||||
"summary": ""
|
||||
},
|
||||
{
|
||||
"path": "app/api/",
|
||||
"action": "untracked",
|
||||
"summary": ""
|
||||
},
|
||||
{
|
||||
"path": "app/components/",
|
||||
"action": "untracked",
|
||||
"summary": ""
|
||||
},
|
||||
{
|
||||
"path": "app/lib/",
|
||||
"action": "untracked",
|
||||
"summary": ""
|
||||
},
|
||||
{
|
||||
"path": "app/login/",
|
||||
"action": "untracked",
|
||||
"summary": ""
|
||||
},
|
||||
{
|
||||
"path": "app/register/",
|
||||
"action": "untracked",
|
||||
"summary": ""
|
||||
},
|
||||
{
|
||||
"path": "app/tasks/",
|
||||
"action": "untracked",
|
||||
"summary": ""
|
||||
},
|
||||
{
|
||||
"path": "project_manifest.json",
|
||||
"action": "untracked",
|
||||
"summary": ""
|
||||
},
|
||||
{
|
||||
"path": "skills/",
|
||||
"action": "untracked",
|
||||
"summary": ""
|
||||
},
|
||||
{
|
||||
"path": "start-workflow.sh",
|
||||
"action": "untracked",
|
||||
"summary": ""
|
||||
}
|
||||
]
|
||||
|
|
@ -0,0 +1,58 @@
|
|||
{
|
||||
"feature": "a complete to earn app",
|
||||
"gathered_at": "2025-12-18",
|
||||
"mode": "auto",
|
||||
"requirements": {
|
||||
"earning_mechanisms": {
|
||||
"task_based": true,
|
||||
"learning_based": true,
|
||||
"game_based": false,
|
||||
"activity_based": false,
|
||||
"task_types": {
|
||||
"daily_checkins": true,
|
||||
"watch_ads": true,
|
||||
"surveys": true,
|
||||
"referrals": true
|
||||
},
|
||||
"learning_types": {
|
||||
"quizzes": true,
|
||||
"video_lessons": true,
|
||||
"reading_challenges": true,
|
||||
"flashcards": false
|
||||
}
|
||||
},
|
||||
"rewards": {
|
||||
"points_coins": true,
|
||||
"badges_achievements": true,
|
||||
"gift_cards": false,
|
||||
"cryptocurrency": false
|
||||
},
|
||||
"authentication": {
|
||||
"email_password": true,
|
||||
"social_login": false,
|
||||
"anonymous": false
|
||||
},
|
||||
"user_profile": {
|
||||
"points_balance_history": true,
|
||||
"leaderboard": true,
|
||||
"level_xp_system": false,
|
||||
"badge_showcase": false
|
||||
},
|
||||
"ui_style": "modern_dark_theme"
|
||||
},
|
||||
"acceptance_criteria": [
|
||||
"User can register with email and password",
|
||||
"User can log in and view their dashboard",
|
||||
"User can complete daily check-in to earn points",
|
||||
"User can watch video ads to earn points",
|
||||
"User can complete surveys to earn points",
|
||||
"User can refer friends and earn bonus points",
|
||||
"User can complete quiz challenges to earn points",
|
||||
"User can watch educational videos to earn points",
|
||||
"User can read articles and complete challenges to earn points",
|
||||
"User can view their points balance and transaction history",
|
||||
"User can earn badges for achievements",
|
||||
"User can see their position on the leaderboard",
|
||||
"App has modern dark theme UI"
|
||||
]
|
||||
}
|
||||
|
|
@ -0,0 +1,41 @@
|
|||
## Context Recovery - Resuming Previous Session
|
||||
|
||||
### Session Info
|
||||
- **Original Session**: compact_20251218_021138
|
||||
- **Captured At**: 2025-12-18T02:11:38.618766
|
||||
- **Context Usage**: 85.0%
|
||||
|
||||
### Workflow Position
|
||||
- **Phase**: UNKNOWN
|
||||
- **Active Task**: None
|
||||
- **Layer**: 1
|
||||
|
||||
### What Was Being Worked On
|
||||
- **Entity**: ()
|
||||
- **Action**: pending
|
||||
- **File**: None
|
||||
- **Progress**:
|
||||
|
||||
### Next Actions (Priority Order)
|
||||
|
||||
### Recent Changes
|
||||
- `pp/page.tsx` - modified:
|
||||
- `.claude/` - untracked:
|
||||
- `.eureka-active-session` - untracked:
|
||||
- `.mcp.json` - untracked:
|
||||
- `.workflow/` - untracked:
|
||||
- `CLAUDE.md` - untracked:
|
||||
- `app/api/` - untracked:
|
||||
- `app/components/` - untracked:
|
||||
- `app/lib/` - untracked:
|
||||
- `app/login/` - untracked:
|
||||
- `app/register/` - untracked:
|
||||
- `app/tasks/` - untracked:
|
||||
- `project_manifest.json` - untracked:
|
||||
- `skills/` - untracked:
|
||||
- `start-workflow.sh` - untracked:
|
||||
|
||||
---
|
||||
**Action Required**: Continue from the next action listed above.
|
||||
|
||||
To load full context, read the following files:
|
||||
|
|
@ -0,0 +1,35 @@
|
|||
{
|
||||
"version": "v001",
|
||||
"feature": "a complete to earn app",
|
||||
"session_id": "workflow_20251218_013734",
|
||||
"parent_version": null,
|
||||
"status": "completed",
|
||||
"started_at": "2025-12-18T01:37:34.999814",
|
||||
"completed_at": "2025-12-18T02:16:34.986099",
|
||||
"current_phase": "COMPLETED",
|
||||
"approvals": {
|
||||
"design": {
|
||||
"status": "approved",
|
||||
"approved_by": "auto",
|
||||
"approved_at": "2025-12-18T01:55:00Z",
|
||||
"rejection_reason": null
|
||||
},
|
||||
"implementation": {
|
||||
"status": "approved",
|
||||
"approved_by": "auto",
|
||||
"approved_at": "2025-12-18T02:16:34.986102",
|
||||
"rejection_reason": null
|
||||
}
|
||||
},
|
||||
"task_sessions": [],
|
||||
"summary": {
|
||||
"total_tasks": 40,
|
||||
"tasks_completed": 40,
|
||||
"entities_created": 40,
|
||||
"entities_updated": 0,
|
||||
"entities_deleted": 0,
|
||||
"files_created": 40,
|
||||
"files_updated": 0,
|
||||
"files_deleted": 0
|
||||
}
|
||||
}
|
||||
|
|
@ -0,0 +1,23 @@
|
|||
{
|
||||
"project": {
|
||||
"name": "todo-super",
|
||||
"version": "0.1.0",
|
||||
"description": "A complete earn-to-play app",
|
||||
"tech_stack": {
|
||||
"framework": "Next.js 16",
|
||||
"language": "TypeScript",
|
||||
"styling": "Tailwind CSS 4",
|
||||
"runtime": "React 19"
|
||||
}
|
||||
},
|
||||
"state": {
|
||||
"current_phase": "DESIGN_PHASE",
|
||||
"last_updated": "2025-12-18"
|
||||
},
|
||||
"entities": {
|
||||
"components": [],
|
||||
"pages": [],
|
||||
"api_endpoints": [],
|
||||
"data_models": []
|
||||
}
|
||||
}
|
||||
|
|
@ -0,0 +1,21 @@
|
|||
{
|
||||
"id": "task_create_api_auth_login",
|
||||
"type": "create",
|
||||
"title": "Create api_auth_login",
|
||||
"agent": "backend",
|
||||
"entity_id": "api_auth_login",
|
||||
"entity_ids": [
|
||||
"api_auth_login"
|
||||
],
|
||||
"status": "pending",
|
||||
"layer": 1,
|
||||
"parallel_group": "layer_1",
|
||||
"complexity": "medium",
|
||||
"dependencies": [],
|
||||
"context": {
|
||||
"design_version": 1,
|
||||
"workflow_version": "v001",
|
||||
"context_snapshot_path": ".workflow/versions/v001/contexts/api_auth_login.yml"
|
||||
},
|
||||
"created_at": "2025-12-18T01:57:52.724887"
|
||||
}
|
||||
|
|
@ -0,0 +1,21 @@
|
|||
{
|
||||
"id": "task_create_api_auth_me",
|
||||
"type": "create",
|
||||
"title": "Create api_auth_me",
|
||||
"agent": "backend",
|
||||
"entity_id": "api_auth_me",
|
||||
"entity_ids": [
|
||||
"api_auth_me"
|
||||
],
|
||||
"status": "pending",
|
||||
"layer": 1,
|
||||
"parallel_group": "layer_1",
|
||||
"complexity": "medium",
|
||||
"dependencies": [],
|
||||
"context": {
|
||||
"design_version": 1,
|
||||
"workflow_version": "v001",
|
||||
"context_snapshot_path": ".workflow/versions/v001/contexts/api_auth_me.yml"
|
||||
},
|
||||
"created_at": "2025-12-18T01:57:52.724946"
|
||||
}
|
||||
|
|
@ -0,0 +1,21 @@
|
|||
{
|
||||
"id": "task_create_api_auth_register",
|
||||
"type": "create",
|
||||
"title": "Create api_auth_register",
|
||||
"agent": "backend",
|
||||
"entity_id": "api_auth_register",
|
||||
"entity_ids": [
|
||||
"api_auth_register"
|
||||
],
|
||||
"status": "pending",
|
||||
"layer": 1,
|
||||
"parallel_group": "layer_1",
|
||||
"complexity": "medium",
|
||||
"dependencies": [],
|
||||
"context": {
|
||||
"design_version": 1,
|
||||
"workflow_version": "v001",
|
||||
"context_snapshot_path": ".workflow/versions/v001/contexts/api_auth_register.yml"
|
||||
},
|
||||
"created_at": "2025-12-18T01:57:52.725003"
|
||||
}
|
||||
|
|
@ -0,0 +1,21 @@
|
|||
{
|
||||
"id": "task_create_api_leaderboard",
|
||||
"type": "create",
|
||||
"title": "Create api_leaderboard",
|
||||
"agent": "backend",
|
||||
"entity_id": "api_leaderboard",
|
||||
"entity_ids": [
|
||||
"api_leaderboard"
|
||||
],
|
||||
"status": "pending",
|
||||
"layer": 1,
|
||||
"parallel_group": "layer_1",
|
||||
"complexity": "medium",
|
||||
"dependencies": [],
|
||||
"context": {
|
||||
"design_version": 1,
|
||||
"workflow_version": "v001",
|
||||
"context_snapshot_path": ".workflow/versions/v001/contexts/api_leaderboard.yml"
|
||||
},
|
||||
"created_at": "2025-12-18T01:57:52.725061"
|
||||
}
|
||||
|
|
@ -0,0 +1,21 @@
|
|||
{
|
||||
"id": "task_create_api_quizzes_get",
|
||||
"type": "create",
|
||||
"title": "Create api_quizzes_get",
|
||||
"agent": "backend",
|
||||
"entity_id": "api_quizzes_get",
|
||||
"entity_ids": [
|
||||
"api_quizzes_get"
|
||||
],
|
||||
"status": "pending",
|
||||
"layer": 1,
|
||||
"parallel_group": "layer_1",
|
||||
"complexity": "medium",
|
||||
"dependencies": [],
|
||||
"context": {
|
||||
"design_version": 1,
|
||||
"workflow_version": "v001",
|
||||
"context_snapshot_path": ".workflow/versions/v001/contexts/api_quizzes_get.yml"
|
||||
},
|
||||
"created_at": "2025-12-18T01:57:52.725120"
|
||||
}
|
||||
|
|
@ -0,0 +1,21 @@
|
|||
{
|
||||
"id": "task_create_api_quizzes_submit",
|
||||
"type": "create",
|
||||
"title": "Create api_quizzes_submit",
|
||||
"agent": "backend",
|
||||
"entity_id": "api_quizzes_submit",
|
||||
"entity_ids": [
|
||||
"api_quizzes_submit"
|
||||
],
|
||||
"status": "pending",
|
||||
"layer": 1,
|
||||
"parallel_group": "layer_1",
|
||||
"complexity": "medium",
|
||||
"dependencies": [],
|
||||
"context": {
|
||||
"design_version": 1,
|
||||
"workflow_version": "v001",
|
||||
"context_snapshot_path": ".workflow/versions/v001/contexts/api_quizzes_submit.yml"
|
||||
},
|
||||
"created_at": "2025-12-18T01:57:52.725176"
|
||||
}
|
||||
|
|
@ -0,0 +1,21 @@
|
|||
{
|
||||
"id": "task_create_api_referrals_claim",
|
||||
"type": "create",
|
||||
"title": "Create api_referrals_claim",
|
||||
"agent": "backend",
|
||||
"entity_id": "api_referrals_claim",
|
||||
"entity_ids": [
|
||||
"api_referrals_claim"
|
||||
],
|
||||
"status": "pending",
|
||||
"layer": 1,
|
||||
"parallel_group": "layer_1",
|
||||
"complexity": "medium",
|
||||
"dependencies": [],
|
||||
"context": {
|
||||
"design_version": 1,
|
||||
"workflow_version": "v001",
|
||||
"context_snapshot_path": ".workflow/versions/v001/contexts/api_referrals_claim.yml"
|
||||
},
|
||||
"created_at": "2025-12-18T01:57:52.725232"
|
||||
}
|
||||
|
|
@ -0,0 +1,21 @@
|
|||
{
|
||||
"id": "task_create_api_referrals_create",
|
||||
"type": "create",
|
||||
"title": "Create api_referrals_create",
|
||||
"agent": "backend",
|
||||
"entity_id": "api_referrals_create",
|
||||
"entity_ids": [
|
||||
"api_referrals_create"
|
||||
],
|
||||
"status": "pending",
|
||||
"layer": 1,
|
||||
"parallel_group": "layer_1",
|
||||
"complexity": "medium",
|
||||
"dependencies": [],
|
||||
"context": {
|
||||
"design_version": 1,
|
||||
"workflow_version": "v001",
|
||||
"context_snapshot_path": ".workflow/versions/v001/contexts/api_referrals_create.yml"
|
||||
},
|
||||
"created_at": "2025-12-18T01:57:52.725285"
|
||||
}
|
||||
|
|
@ -0,0 +1,21 @@
|
|||
{
|
||||
"id": "task_create_api_tasks_checkin",
|
||||
"type": "create",
|
||||
"title": "Create api_tasks_checkin",
|
||||
"agent": "backend",
|
||||
"entity_id": "api_tasks_checkin",
|
||||
"entity_ids": [
|
||||
"api_tasks_checkin"
|
||||
],
|
||||
"status": "pending",
|
||||
"layer": 1,
|
||||
"parallel_group": "layer_1",
|
||||
"complexity": "medium",
|
||||
"dependencies": [],
|
||||
"context": {
|
||||
"design_version": 1,
|
||||
"workflow_version": "v001",
|
||||
"context_snapshot_path": ".workflow/versions/v001/contexts/api_tasks_checkin.yml"
|
||||
},
|
||||
"created_at": "2025-12-18T01:57:52.725338"
|
||||
}
|
||||
|
|
@ -0,0 +1,21 @@
|
|||
{
|
||||
"id": "task_create_api_tasks_complete",
|
||||
"type": "create",
|
||||
"title": "Create api_tasks_complete",
|
||||
"agent": "backend",
|
||||
"entity_id": "api_tasks_complete",
|
||||
"entity_ids": [
|
||||
"api_tasks_complete"
|
||||
],
|
||||
"status": "pending",
|
||||
"layer": 1,
|
||||
"parallel_group": "layer_1",
|
||||
"complexity": "medium",
|
||||
"dependencies": [],
|
||||
"context": {
|
||||
"design_version": 1,
|
||||
"workflow_version": "v001",
|
||||
"context_snapshot_path": ".workflow/versions/v001/contexts/api_tasks_complete.yml"
|
||||
},
|
||||
"created_at": "2025-12-18T01:57:52.725390"
|
||||
}
|
||||
|
|
@ -0,0 +1,21 @@
|
|||
{
|
||||
"id": "task_create_api_tasks_list",
|
||||
"type": "create",
|
||||
"title": "Create api_tasks_list",
|
||||
"agent": "backend",
|
||||
"entity_id": "api_tasks_list",
|
||||
"entity_ids": [
|
||||
"api_tasks_list"
|
||||
],
|
||||
"status": "pending",
|
||||
"layer": 1,
|
||||
"parallel_group": "layer_1",
|
||||
"complexity": "medium",
|
||||
"dependencies": [],
|
||||
"context": {
|
||||
"design_version": 1,
|
||||
"workflow_version": "v001",
|
||||
"context_snapshot_path": ".workflow/versions/v001/contexts/api_tasks_list.yml"
|
||||
},
|
||||
"created_at": "2025-12-18T01:57:52.725451"
|
||||
}
|
||||
|
|
@ -0,0 +1,21 @@
|
|||
{
|
||||
"id": "task_create_api_users_badges",
|
||||
"type": "create",
|
||||
"title": "Create api_users_badges",
|
||||
"agent": "backend",
|
||||
"entity_id": "api_users_badges",
|
||||
"entity_ids": [
|
||||
"api_users_badges"
|
||||
],
|
||||
"status": "pending",
|
||||
"layer": 1,
|
||||
"parallel_group": "layer_1",
|
||||
"complexity": "medium",
|
||||
"dependencies": [],
|
||||
"context": {
|
||||
"design_version": 1,
|
||||
"workflow_version": "v001",
|
||||
"context_snapshot_path": ".workflow/versions/v001/contexts/api_users_badges.yml"
|
||||
},
|
||||
"created_at": "2025-12-18T01:57:52.725510"
|
||||
}
|
||||
|
|
@ -0,0 +1,21 @@
|
|||
{
|
||||
"id": "task_create_api_users_points",
|
||||
"type": "create",
|
||||
"title": "Create api_users_points",
|
||||
"agent": "backend",
|
||||
"entity_id": "api_users_points",
|
||||
"entity_ids": [
|
||||
"api_users_points"
|
||||
],
|
||||
"status": "pending",
|
||||
"layer": 1,
|
||||
"parallel_group": "layer_1",
|
||||
"complexity": "medium",
|
||||
"dependencies": [],
|
||||
"context": {
|
||||
"design_version": 1,
|
||||
"workflow_version": "v001",
|
||||
"context_snapshot_path": ".workflow/versions/v001/contexts/api_users_points.yml"
|
||||
},
|
||||
"created_at": "2025-12-18T01:57:52.725565"
|
||||
}
|
||||
|
|
@ -0,0 +1,21 @@
|
|||
{
|
||||
"id": "task_create_component_auth_form",
|
||||
"type": "create",
|
||||
"title": "Create AuthForm",
|
||||
"agent": "frontend",
|
||||
"entity_id": "component_auth_form",
|
||||
"entity_ids": [
|
||||
"component_auth_form"
|
||||
],
|
||||
"status": "pending",
|
||||
"layer": 1,
|
||||
"parallel_group": "layer_1",
|
||||
"complexity": "medium",
|
||||
"dependencies": [],
|
||||
"context": {
|
||||
"design_version": 1,
|
||||
"workflow_version": "v001",
|
||||
"context_snapshot_path": ".workflow/versions/v001/contexts/component_auth_form.yml"
|
||||
},
|
||||
"created_at": "2025-12-18T01:57:52.725622"
|
||||
}
|
||||
|
|
@ -0,0 +1,21 @@
|
|||
{
|
||||
"id": "task_create_component_badge_card",
|
||||
"type": "create",
|
||||
"title": "Create BadgeCard",
|
||||
"agent": "frontend",
|
||||
"entity_id": "component_badge_card",
|
||||
"entity_ids": [
|
||||
"component_badge_card"
|
||||
],
|
||||
"status": "pending",
|
||||
"layer": 1,
|
||||
"parallel_group": "layer_1",
|
||||
"complexity": "medium",
|
||||
"dependencies": [],
|
||||
"context": {
|
||||
"design_version": 1,
|
||||
"workflow_version": "v001",
|
||||
"context_snapshot_path": ".workflow/versions/v001/contexts/component_badge_card.yml"
|
||||
},
|
||||
"created_at": "2025-12-18T01:57:52.725677"
|
||||
}
|
||||
|
|
@ -0,0 +1,21 @@
|
|||
{
|
||||
"id": "task_create_component_daily_checkin_button",
|
||||
"type": "create",
|
||||
"title": "Create DailyCheckinButton",
|
||||
"agent": "frontend",
|
||||
"entity_id": "component_daily_checkin_button",
|
||||
"entity_ids": [
|
||||
"component_daily_checkin_button"
|
||||
],
|
||||
"status": "pending",
|
||||
"layer": 1,
|
||||
"parallel_group": "layer_1",
|
||||
"complexity": "medium",
|
||||
"dependencies": [],
|
||||
"context": {
|
||||
"design_version": 1,
|
||||
"workflow_version": "v001",
|
||||
"context_snapshot_path": ".workflow/versions/v001/contexts/component_daily_checkin_button.yml"
|
||||
},
|
||||
"created_at": "2025-12-18T01:57:52.725731"
|
||||
}
|
||||
|
|
@ -0,0 +1,21 @@
|
|||
{
|
||||
"id": "task_create_component_dark_theme_layout",
|
||||
"type": "create",
|
||||
"title": "Create DarkThemeLayout",
|
||||
"agent": "frontend",
|
||||
"entity_id": "component_dark_theme_layout",
|
||||
"entity_ids": [
|
||||
"component_dark_theme_layout"
|
||||
],
|
||||
"status": "pending",
|
||||
"layer": 1,
|
||||
"parallel_group": "layer_1",
|
||||
"complexity": "medium",
|
||||
"dependencies": [],
|
||||
"context": {
|
||||
"design_version": 1,
|
||||
"workflow_version": "v001",
|
||||
"context_snapshot_path": ".workflow/versions/v001/contexts/component_dark_theme_layout.yml"
|
||||
},
|
||||
"created_at": "2025-12-18T01:57:52.725786"
|
||||
}
|
||||
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in New Issue