feat: enhanced documentation for readability and conciseness

This commit is contained in:
duthaho
2026-04-19 11:33:01 +07:00
parent 70e258e1dc
commit ab4890ce5f
28 changed files with 1107 additions and 4932 deletions
+6 -9
View File
@@ -38,14 +38,11 @@ Creative exploration mode optimized for ideation, design discussions, and explor
## Activation
Use natural language:
```
Use mode: brainstorm
```
Or use command flag:
```
/plan --mode=brainstorm [task]
/feature --mode=brainstorm [desc]
"switch to brainstorm mode"
"let's brainstorm [topic]"
"explore options for [feature]"
```
---
@@ -110,6 +107,6 @@ For informed technology choices:
## Combines Well With
- `/brainstorm` command
- `/plan` command
- `brainstorming` skill (auto-triggered for creative exploration)
- `writing-plans` skill (transition from exploration to planning)
- Deep research mode (for informed exploration)
+6 -9
View File
@@ -102,14 +102,11 @@ Thorough analysis mode for comprehensive investigation. Prioritizes completeness
## Activation
Use natural language:
```
Use mode: deep-research
```
Or use command flag:
```
/research --mode=deep-research [topic]
/review --depth=5 [file]
"switch to deep-research mode"
"research [topic] thoroughly"
"do a deep investigation of [area]"
```
### Depth Levels
@@ -155,7 +152,7 @@ Build persistent research knowledge:
## Combines Well With
- `/research` command
- Sequential thinking skill
- `sequential-thinking` skill (structured step-by-step analysis)
- `researcher` agent (comprehensive technology research)
- Security audits
- Performance optimization
+5 -8
View File
@@ -33,18 +33,15 @@ This mode is active by default unless another mode is explicitly specified.
This mode is active by default. No activation needed.
To switch to another mode:
To switch to another mode, use natural language:
```
Use mode: [mode-name]
```
Or use command flags:
```
/command --mode=default
"switch to brainstorm mode"
"use implementation mode"
"switch to token-efficient mode"
```
---
## Compatible With
All commands and workflows. This mode provides baseline behavior that other modes modify.
All skills and workflows. This mode provides baseline behavior that other modes modify.
+17 -21
View File
@@ -81,14 +81,11 @@ Done. Created 3 files, all tests passing.
## Activation
Use natural language:
```
Use mode: implementation
```
Or use command flag:
```
/feature --mode=implementation [desc]
/execute-plan --mode=implementation [file]
"switch to implementation mode"
"just code it"
"execute the plan"
```
---
@@ -112,28 +109,27 @@ Continuing with [choice]. Let me know if you'd prefer different.
---
## MCP Integration
## Tool Usage
This mode leverages MCP servers for efficient implementation:
### Filesystem (Primary)
### Built-in Tools (Primary)
```
ALWAYS use Filesystem in implementation mode:
- Use read_file to check existing code
- Use write_file to create new files
- Use edit_file for modifications
- Use search_files to find patterns to follow
Use Claude Code built-in tools for file operations:
- Read to check existing code
- Write to create new files
- Edit for modifications
- Grep/Glob to find patterns to follow
```
### Context7
### MCP Integration
#### Context7
```
For accurate library usage:
- Fetch current API documentation
- Use mode='code' for API references
- Get correct patterns and examples
```
### Memory
#### Memory
```
Recall implementation context:
- Remember established patterns
@@ -143,7 +139,7 @@ Recall implementation context:
## Combines Well With
- `/execute-plan` command
- `executing-plans` skill (structured plan execution)
- `test-driven-development` skill (TDD workflow)
- Token-efficient mode (for maximum efficiency)
- After brainstorm/planning phases
- TDD workflow
+13 -16
View File
@@ -84,16 +84,16 @@ Total work: [description]
---
## Spawn Pattern
## Agent Dispatch Pattern
For launching parallel background tasks:
For launching parallel background tasks using the Agent tool:
```markdown
Spawning parallel agents:
Dispatching parallel agents:
1. `/spawn "Research authentication patterns"`Agent #1
2. `/spawn "Analyze current security"`Agent #2
3. `/spawn "Review competitor approaches"`Agent #3
1. Agent(researcher, "Research authentication patterns")Background #1
2. Agent(security-auditor, "Analyze current security")Background #2
3. Agent(scout-external, "Review competitor approaches")Background #3
Monitoring progress...
@@ -109,14 +109,11 @@ Synthesizing...
## Activation
Use natural language:
```
Use mode: orchestration
```
Or use command flag:
```
/feature --mode=orchestration [desc]
/plan --mode=orchestration [task]
"switch to orchestration mode"
"coordinate these tasks in parallel"
"use parallel agents for this"
```
---
@@ -176,7 +173,7 @@ Between parallel phases:
## Combines Well With
- `/spawn` command
- `/execute-plan` command
- Dispatching-parallel-agents skill
- `dispatching-parallel-agents` skill (structured parallel task dispatch)
- `executing-plans` skill (plan execution with quality gates)
- `subagent-driven-development` skill (automated agent coordination)
- Complex feature development
+13 -10
View File
@@ -95,20 +95,23 @@ Critical analysis mode optimized for code review, auditing, and quality assessme
## Activation
Use natural language:
```
Use mode: review
"switch to review mode"
"review this code critically"
"do a security-focused review"
```
Or use command flag:
Or invoke the `review` skill directly:
```
/review --mode=review [file]
/review --persona=security [file]
/review [PR number or branch]
/security-review
```
### Persona Options
### Review Focus Areas
| Persona | Focus |
|---------|-------|
| Focus | Description |
|-------|-------------|
| `security` | OWASP, vulnerabilities, auth |
| `performance` | Efficiency, caching, queries |
| `architecture` | Patterns, coupling, design |
@@ -176,7 +179,7 @@ For thorough code examination:
## Combines Well With
- `/review` command
- `review` skill (user-invocable PR review)
- `security-review` skill (user-invocable security audit)
- Deep research mode (for thorough audits)
- Security auditor agent
- Code reviewer agent
- `security-auditor` agent, `code-reviewer` agent
+9 -12
View File
@@ -72,22 +72,19 @@ Fix: Add email validation
## Activation
Use natural language:
```
Use mode: token-efficient
"switch to token-efficient mode"
"be concise"
"code only"
```
Or use command flag:
```
/fix --format=concise [error]
/feature --format=ultra [desc]
```
### Verbosity Levels
### Format Levels
| Level | Flag | Savings |
|-------|------|---------|
| Concise | `--format=concise` | 30-40% |
| Ultra | `--format=ultra` | 60-70% |
| Level | Trigger | Savings |
|-------|---------|---------|
| Concise | "be concise" | 30-40% |
| Ultra | "code only" | 60-70% |
---