mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-02-13 02:41:50 +08:00
feat: initialize monorepo with package.json for CCW workflow platform
This commit is contained in:
catlog22
250
ccw/docs-site/docs/workflows/level-1-ultra-lightweight.mdx
Normal file
250
ccw/docs-site/docs/workflows/level-1-ultra-lightweight.mdx
Normal file
@@ -0,0 +1,250 @@
|
||||
---
|
||||
title: Level 1 - Ultra-Lightweight Workflows
|
||||
description: Rapid execution workflow for simple tasks with zero overhead
|
||||
sidebar_position: 2
|
||||
---
|
||||
|
||||
import Mermaid from '@theme/Mermaid';
|
||||
|
||||
# Level 1: Ultra-Lightweight Workflows
|
||||
|
||||
**Complexity**: Low | **Artifacts**: None | **State**: Stateless | **Iteration**: Via AskUser
|
||||
|
||||
The simplest workflow for immediate simple tasks - minimal overhead, direct execution.
|
||||
|
||||
## Overview
|
||||
|
||||
Level 1 workflows are designed for quick, straightforward tasks that don't require planning, documentation, or persistent state. They execute directly from input to completion.
|
||||
|
||||
<Mermaid
|
||||
chart={`
|
||||
flowchart LR
|
||||
Input([User Input]) --> Clarify[Clarification<br/>Optional]
|
||||
Clarify --> Select{Auto-select<br/>CLI}
|
||||
Select --> Analysis[Parallel Analysis<br/>Multi-tool exploration]
|
||||
Analysis --> Results[Show Results]
|
||||
Results --> Execute[Direct Execute]
|
||||
Execute --> Done([Complete])
|
||||
|
||||
classDef startend fill:#c8e6c9,stroke:#388e3c
|
||||
classDef action fill:#e3f2fd,stroke:#1976d2
|
||||
classDef decision fill:#fff9c4,stroke:#f57c00
|
||||
|
||||
class Input,Done startend,Clarify,Select,Analysis,Results,Execute action,Select decision
|
||||
`}
|
||||
/>
|
||||
|
||||
## Included Workflow: lite-lite-lite
|
||||
|
||||
### Command
|
||||
|
||||
```bash
|
||||
/workflow:lite-lite-lite
|
||||
# Or CCW auto-selects for simple tasks
|
||||
```
|
||||
|
||||
### Flow Diagram
|
||||
|
||||
<Mermaid
|
||||
chart={`
|
||||
flowchart TD
|
||||
A([User Input]) --> B{Clarification<br/>Needed?}
|
||||
B -->|Yes| C[AskUserQuestion<br/>Goal/Scope/Constraints]
|
||||
B -->|No| D[Task Analysis]
|
||||
C --> D
|
||||
|
||||
D --> E{CLI Selection}
|
||||
E --> F[Gemini<br/>Analysis]
|
||||
E --> G[Codex<br/>Implementation]
|
||||
E --> H[Claude<br/>Reasoning]
|
||||
|
||||
F --> I[Aggregate Results]
|
||||
G --> I
|
||||
H --> I
|
||||
|
||||
I --> J{Direct<br/>Execute?}
|
||||
J -->|Yes| K[Execute Directly]
|
||||
J -->|Iterate| L[Refine via AskUser]
|
||||
L --> K
|
||||
|
||||
K --> M([Complete])
|
||||
|
||||
classDef startend fill:#c8e6c9,stroke:#388e3c
|
||||
classDef action fill:#e3f2fd,stroke:#1976d2
|
||||
classDef decision fill:#fff9c4,stroke:#f57c00
|
||||
|
||||
class A,M startend,B,E,J decision,C,D,F,G,H,I,K action
|
||||
`}
|
||||
/>
|
||||
|
||||
### Characteristics
|
||||
|
||||
| Property | Value |
|
||||
|----------|-------|
|
||||
| **Complexity** | Low |
|
||||
| **Artifacts** | None (no intermediate files) |
|
||||
| **State** | Stateless |
|
||||
| **CLI Selection** | Auto-analyze task type |
|
||||
| **Iteration** | Via AskUser interaction |
|
||||
|
||||
### Process Phases
|
||||
|
||||
1. **Input Analysis**
|
||||
- Parse user input for task intent
|
||||
- Detect complexity level
|
||||
- Identify required CLI tools
|
||||
|
||||
2. **Optional Clarification** (if clarity_score < 2)
|
||||
- Goal: Create/Fix/Optimize/Analyze
|
||||
- Scope: Single file/Module/Cross-module
|
||||
- Constraints: Backward compat/Skip tests/Urgent hotfix
|
||||
|
||||
3. **CLI Auto-Selection**
|
||||
- Task type -> CLI tool mapping
|
||||
- Parallel analysis across multiple tools
|
||||
- Aggregated result presentation
|
||||
|
||||
4. **Direct Execution**
|
||||
- Execute changes immediately
|
||||
- No intermediate artifacts
|
||||
- Optional iteration via AskUser
|
||||
|
||||
### CLI Selection Logic
|
||||
|
||||
```javascript
|
||||
function selectCLI(task) {
|
||||
const patterns = {
|
||||
'gemini': /analyze|review|understand|explore/,
|
||||
'codex': /implement|generate|create|write code/,
|
||||
'claude': /debug|fix|optimize|refactor/,
|
||||
'qwen': /consult|discuss|compare/
|
||||
};
|
||||
|
||||
for (const [cli, pattern] of Object.entries(patterns)) {
|
||||
if (pattern.test(task)) return cli;
|
||||
}
|
||||
return 'gemini'; // Default
|
||||
}
|
||||
```
|
||||
|
||||
## Use Cases
|
||||
|
||||
### When to Use
|
||||
|
||||
- Quick fixes (simple typos, minor adjustments)
|
||||
- Simple feature additions (single function, small utility)
|
||||
- Configuration adjustments (environment variables, config files)
|
||||
- Small-scope renaming (variable names, function names)
|
||||
- Documentation updates (readme, comments)
|
||||
|
||||
### When NOT to Use
|
||||
|
||||
- Multi-module changes (use Level 2+)
|
||||
- Need persistent records (use Level 3+)
|
||||
- Complex refactoring (use Level 3-4)
|
||||
- Test-driven development (use Level 3 TDD)
|
||||
- Architecture design (use Level 4-5)
|
||||
|
||||
## Examples
|
||||
|
||||
### Example 1: Quick Fix
|
||||
|
||||
```bash
|
||||
/workflow:lite-lite-lite "Fix typo in function name: getUserData"
|
||||
```
|
||||
|
||||
**Flow**:
|
||||
1. Detect: Simple typo fix
|
||||
2. Select: Codex for refactoring
|
||||
3. Execute: Direct rename across files
|
||||
4. Complete: No artifacts generated
|
||||
|
||||
### Example 2: Simple Feature
|
||||
|
||||
```bash
|
||||
/workflow:lite-lite-lite "Add logging to user login function"
|
||||
```
|
||||
|
||||
**Flow**:
|
||||
1. Detect: Single-module feature
|
||||
2. Select: Claude for implementation
|
||||
3. Clarify: Log level? Output destination?
|
||||
4. Execute: Add log statements
|
||||
5. Complete: Working code
|
||||
|
||||
### Example 3: Config Adjustment
|
||||
|
||||
```bash
|
||||
/workflow:lite-lite-lite "Update API timeout to 30 seconds"
|
||||
```
|
||||
|
||||
**Flow**:
|
||||
1. Detect: Config change
|
||||
2. Select: Gemini for analysis
|
||||
3. Analysis: Find all timeout configs
|
||||
4. Execute: Update values
|
||||
5. Complete: Configuration updated
|
||||
|
||||
## Pros & Cons
|
||||
|
||||
### Pros
|
||||
|
||||
| Benefit | Description |
|
||||
|---------|-------------|
|
||||
| **Speed** | Fastest workflow, zero overhead |
|
||||
| **Simplicity** | No planning or documentation |
|
||||
| **Direct** | Input -> Execute -> Complete |
|
||||
| **No Artifacts** | Clean workspace, no file clutter |
|
||||
| **Low Cognitive Load** | Simple, straightforward execution |
|
||||
|
||||
### Cons
|
||||
|
||||
| Limitation | Description |
|
||||
|------------|-------------|
|
||||
| **No Trace** | No record of changes made |
|
||||
| **No Planning** | Can't handle complex tasks |
|
||||
| **No Review** | No built-in code review |
|
||||
| **Limited Scope** | Single-module only |
|
||||
| **No Rollback** | Changes are immediate |
|
||||
|
||||
## Comparison with Other Levels
|
||||
|
||||
| Aspect | Level 1 | Level 2 | Level 3 |
|
||||
|--------|---------|---------|---------|
|
||||
| **Planning** | None | In-memory | Persistent |
|
||||
| **Artifacts** | None | Memory files | Session files |
|
||||
| **Complexity** | Low | Low-Medium | Medium-High |
|
||||
| **Traceability** | No | Partial | Full |
|
||||
| **Review** | No | Optional | Built-in |
|
||||
|
||||
## When to Graduate to Higher Levels
|
||||
|
||||
**Signs you need Level 2+**:
|
||||
|
||||
- Task involves multiple modules
|
||||
- Need to track progress
|
||||
- Requirements need clarification
|
||||
- Want code review
|
||||
- Need test generation
|
||||
|
||||
**Migration path**:
|
||||
|
||||
<Mermaid
|
||||
chart={`
|
||||
graph LR
|
||||
L1["Level 1:<br/>lite-lite-lite"] --> L2["Level 2:<br/>lite-plan"]
|
||||
L2 --> L3["Level 3:<br/>plan"]
|
||||
L3 --> L4["Level 4:<br/>brainstorm"]
|
||||
L4 --> L5["Level 5:<br/>ccw-coordinator"]
|
||||
|
||||
classDef node fill:#e3f2fd,stroke:#1976d2
|
||||
|
||||
class L1,L2,L3,L4,L5 node
|
||||
`}
|
||||
/>
|
||||
|
||||
## Related Workflows
|
||||
|
||||
- [Level 2: Rapid Workflows](./level-2-rapid.mdx) - Next level up with planning
|
||||
- [Level 3: Standard Workflows](./level-3-standard.mdx) - Full session management
|
||||
- [FAQ](./faq.mdx) - Common questions
|
||||
Reference in New Issue
Block a user