@ngxtm/devkit 3.19.0 → 3.20.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/merged-commands/application-performance-performance-optimization.md +13 -13
- package/merged-commands/ask/fast.md +14 -57
- package/merged-commands/ask/hard.md +22 -79
- package/merged-commands/auto.md +6 -33
- package/merged-commands/backend-development-feature-development.md +12 -12
- package/merged-commands/bootstrap/auto/fast.md +15 -15
- package/merged-commands/bootstrap/auto/parallel.md +12 -12
- package/merged-commands/bootstrap/auto.md +14 -14
- package/merged-commands/bootstrap.md +15 -15
- package/merged-commands/brainstorm/fast.md +19 -72
- package/merged-commands/brainstorm/hard.md +23 -84
- package/merged-commands/c4-architecture-c4-architecture.md +5 -5
- package/merged-commands/code/auto.md +16 -16
- package/merged-commands/code/fast.md +19 -72
- package/merged-commands/code/hard.md +38 -122
- package/merged-commands/code/no-test.md +12 -12
- package/merged-commands/code/parallel.md +9 -9
- package/merged-commands/code.md +14 -14
- package/merged-commands/comprehensive-review-full-review.md +8 -8
- package/merged-commands/context-degradation.md +2 -2
- package/merged-commands/context-engineering.md +4 -4
- package/merged-commands/context-optimization.md +3 -3
- package/merged-commands/cook/auto/fast.md +3 -3
- package/merged-commands/cook/auto/parallel.md +9 -9
- package/merged-commands/cook/auto.md +1 -1
- package/merged-commands/cook/fast.md +38 -47
- package/merged-commands/cook/hard.md +46 -41
- package/merged-commands/cook.md +13 -13
- package/merged-commands/daily-news-report.md +15 -15
- package/merged-commands/data-engineering-data-driven-feature.md +16 -16
- package/merged-commands/debug/fast.md +13 -29
- package/merged-commands/debug/hard.md +47 -49
- package/merged-commands/debug.md +1 -1
- package/merged-commands/debugging-toolkit-smart-debug.md +1 -1
- package/merged-commands/deploy/check.md +22 -71
- package/merged-commands/deploy/preview.md +18 -62
- package/merged-commands/deploy/production.md +22 -71
- package/merged-commands/deploy/rollback.md +22 -71
- package/merged-commands/deploy.md +0 -11
- package/merged-commands/design/3d.md +3 -3
- package/merged-commands/design/describe.md +1 -1
- package/merged-commands/design/fast.md +2 -2
- package/merged-commands/design/good.md +3 -3
- package/merged-commands/design/hard.md +15 -85
- package/merged-commands/design/screenshot.md +1 -1
- package/merged-commands/design/video.md +1 -1
- package/merged-commands/design.md +0 -11
- package/merged-commands/doc-coauthoring.md +5 -5
- package/merged-commands/docker-expert.md +1 -1
- package/merged-commands/docs/audit.md +26 -77
- package/merged-commands/docs/business.md +26 -77
- package/merged-commands/docs/core.md +24 -68
- package/merged-commands/docs/init.md +8 -8
- package/merged-commands/docs/update.md +13 -13
- package/merged-commands/docs.md +0 -12
- package/merged-commands/error-debugging-multi-agent-review.md +1 -1
- package/merged-commands/error-diagnostics-smart-debug.md +1 -1
- package/merged-commands/finishing-a-development-branch.md +1 -1
- package/merged-commands/fix/ci.md +2 -2
- package/merged-commands/fix/fast.md +2 -2
- package/merged-commands/fix/hard.md +6 -6
- package/merged-commands/fix/logs.md +5 -5
- package/merged-commands/fix/parallel.md +9 -9
- package/merged-commands/fix/test.md +6 -6
- package/merged-commands/fix/ui.md +8 -8
- package/merged-commands/fixing.md +3 -3
- package/merged-commands/framework-migration-legacy-modernize.md +13 -13
- package/merged-commands/full-stack-orchestration-full-stack-feature.md +12 -12
- package/merged-commands/git/cm.md +1 -1
- package/merged-commands/git/cp.md +1 -1
- package/merged-commands/git/merge.md +1 -1
- package/merged-commands/git/pr.md +1 -1
- package/merged-commands/git-pr-workflows-git-workflow.md +10 -10
- package/merged-commands/google-adk-python.md +1 -1
- package/merged-commands/hr-pro.md +1 -1
- package/merged-commands/incident-response-incident-response.md +13 -13
- package/merged-commands/integrate/polar.md +3 -3
- package/merged-commands/integrate/sepay.md +3 -3
- package/merged-commands/journal.md +1 -1
- package/merged-commands/linear-claude-skill.md +2 -2
- package/merged-commands/loki-mode.md +14 -14
- package/merged-commands/machine-learning-ops-ml-pipeline.md +7 -7
- package/merged-commands/mcp-management.md +8 -8
- package/merged-commands/multi-agent-patterns.md +14 -14
- package/merged-commands/multi-platform-apps-multi-platform.md +10 -10
- package/merged-commands/nestjs-expert.md +1 -1
- package/merged-commands/performance-testing-review-multi-agent-review.md +1 -1
- package/merged-commands/plan/archive.md +1 -1
- package/merged-commands/plan/ci.md +1 -1
- package/merged-commands/plan/fast.md +2 -2
- package/merged-commands/plan/hard.md +4 -4
- package/merged-commands/plan/parallel.md +5 -5
- package/merged-commands/plan/two.md +6 -6
- package/merged-commands/requesting-code-review.md +6 -6
- package/merged-commands/review/codebase/parallel.md +5 -5
- package/merged-commands/review/codebase.md +5 -5
- package/merged-commands/review/fast.md +13 -29
- package/merged-commands/review/hard.md +48 -49
- package/merged-commands/review.md +0 -11
- package/merged-commands/security-scanning-security-hardening.md +13 -13
- package/merged-commands/skill/add.md +6 -6
- package/merged-commands/skill/create.md +6 -6
- package/merged-commands/skill/fix-logs.md +6 -6
- package/merged-commands/skill/optimize/auto.md +1 -1
- package/merged-commands/skill/optimize.md +1 -1
- package/merged-commands/skill/plan.md +1 -1
- package/merged-commands/skill/update.md +6 -6
- package/merged-commands/subagent-driven-development.md +53 -53
- package/merged-commands/tdd-workflows-tdd-cycle.md +12 -12
- package/merged-commands/tdd-workflows-tdd-red.md +1 -1
- package/merged-commands/tdd-workflows-tdd-refactor.md +1 -1
- package/merged-commands/test/fast.md +22 -33
- package/merged-commands/test/hard.md +59 -56
- package/merged-commands/test/ui.md +1 -1
- package/merged-commands/test.md +1 -1
- package/merged-commands/typescript-expert.md +1 -1
- package/merged-commands/use-mcp.md +5 -5
- package/merged-commands/writing-plans.md +3 -3
- package/merged-commands/writing-skills.md +8 -8
- package/package.json +1 -1
- package/rules-index.json +1 -1
- package/skills/application-performance-performance-optimization/SKILL.md +13 -13
- package/skills/azure-ai-agents-python/references/tools.md +1 -1
- package/skills/backend-development-feature-development/SKILL.md +12 -12
- package/skills/best-practices/references/anti-patterns.md +2 -2
- package/skills/best-practices/references/best-practices-guide.md +14 -14
- package/skills/c4-architecture-c4-architecture/SKILL.md +5 -5
- package/skills/comprehensive-review-full-review/SKILL.md +8 -8
- package/skills/context-degradation/SKILL.md +2 -2
- package/skills/context-engineering/SKILL.md +4 -4
- package/skills/context-engineering/references/context-degradation.md +1 -1
- package/skills/context-engineering/references/context-optimization.md +1 -1
- package/skills/context-engineering/references/multi-agent-patterns.md +1 -1
- package/skills/context-engineering/references/runtime-awareness.md +1 -1
- package/skills/context-optimization/SKILL.md +3 -3
- package/skills/daily-news-report/SKILL.md +15 -15
- package/skills/data-engineering-data-driven-feature/SKILL.md +16 -16
- package/skills/debugging-toolkit-smart-debug/SKILL.md +1 -1
- package/skills/doc-coauthoring/SKILL.md +5 -5
- package/skills/docker-expert/SKILL.md +1 -1
- package/skills/error-debugging-multi-agent-review/SKILL.md +1 -1
- package/skills/error-diagnostics-smart-debug/SKILL.md +1 -1
- package/skills/finishing-a-development-branch/SKILL.md +1 -1
- package/skills/fixing/SKILL.md +3 -3
- package/skills/fixing/references/parallel-exploration.md +4 -4
- package/skills/fixing/references/skill-activation-matrix.md +3 -3
- package/skills/fixing/references/workflow-deep.md +11 -11
- package/skills/fixing/references/workflow-quick.md +4 -4
- package/skills/fixing/references/workflow-standard.md +12 -12
- package/skills/framework-migration-legacy-modernize/SKILL.md +13 -13
- package/skills/full-stack-orchestration-full-stack-feature/SKILL.md +12 -12
- package/skills/git-pr-workflows-git-workflow/SKILL.md +10 -10
- package/skills/google-adk-python/SKILL.md +1 -1
- package/skills/hr-pro/SKILL.md +1 -1
- package/skills/incident-response-incident-response/SKILL.md +13 -13
- package/skills/incident-response-smart-fix/resources/implementation-playbook.md +17 -17
- package/skills/linear-claude-skill/SKILL.md +2 -2
- package/skills/loki-mode/ACKNOWLEDGEMENTS.md +4 -4
- package/skills/loki-mode/CHANGELOG.md +9 -9
- package/skills/loki-mode/CONTEXT-EXPORT.md +1 -1
- package/skills/loki-mode/README.md +2 -2
- package/skills/loki-mode/SKILL.md +14 -14
- package/skills/loki-mode/autonomy/run.sh +1 -1
- package/skills/loki-mode/integrations/vibe-kanban.md +1 -1
- package/skills/loki-mode/references/core-workflow.md +4 -4
- package/skills/loki-mode/references/production-patterns.md +6 -6
- package/skills/loki-mode/references/quality-control.md +2 -2
- package/skills/loki-mode/references/sdlc-phases.md +3 -3
- package/skills/machine-learning-ops-ml-pipeline/SKILL.md +7 -7
- package/skills/mcp-builder/reference/evaluation.md +3 -3
- package/skills/mcp-management/README.md +6 -6
- package/skills/mcp-management/SKILL.md +8 -8
- package/skills/mcp-management/references/gemini-cli-integration.md +1 -1
- package/skills/multi-agent-patterns/SKILL.md +14 -14
- package/skills/multi-platform-apps-multi-platform/SKILL.md +10 -10
- package/skills/nestjs-expert/SKILL.md +1 -1
- package/skills/performance-testing-review-multi-agent-review/SKILL.md +1 -1
- package/skills/planning-with-files/reference.md +2 -2
- package/skills/requesting-code-review/SKILL.md +6 -6
- package/skills/security-scanning-security-hardening/SKILL.md +13 -13
- package/skills/subagent-driven-development/SKILL.md +53 -53
- package/skills/subagent-driven-development/code-quality-reviewer-prompt.md +1 -1
- package/skills/subagent-driven-development/implementer-prompt.md +3 -3
- package/skills/subagent-driven-development/spec-reviewer-prompt.md +1 -1
- package/skills/tdd-workflows-tdd-cycle/SKILL.md +12 -12
- package/skills/tdd-workflows-tdd-green/resources/implementation-playbook.md +1 -1
- package/skills/tdd-workflows-tdd-red/SKILL.md +1 -1
- package/skills/tdd-workflows-tdd-refactor/SKILL.md +1 -1
- package/skills/typescript-expert/SKILL.md +1 -1
- package/skills/writing-plans/SKILL.md +3 -3
- package/skills/writing-skills/SKILL.md +8 -8
- package/skills/writing-skills/examples/CLAUDE_MD_TESTING.md +1 -1
- package/skills/writing-skills/references/cso/README.md +3 -3
- package/skills/writing-skills/testing-skills-with-subagents.md +1 -1
|
@@ -81,10 +81,10 @@ Design prompts to maximize cache stability: avoid dynamic content like timestamp
|
|
|
81
81
|
|
|
82
82
|
### Context Partitioning
|
|
83
83
|
|
|
84
|
-
**
|
|
85
|
-
The most aggressive form of context optimization is partitioning work across
|
|
84
|
+
**Task Agent Partitioning**
|
|
85
|
+
The most aggressive form of context optimization is partitioning work across Task agents with isolated contexts. Each Task agent operates in a clean context focused on its subtask without carrying accumulated context from other subtasks.
|
|
86
86
|
|
|
87
|
-
This approach achieves separation of concerns—the detailed search context remains isolated within
|
|
87
|
+
This approach achieves separation of concerns—the detailed search context remains isolated within Task agents while the coordinator focuses on synthesis and analysis.
|
|
88
88
|
|
|
89
89
|
**Result Aggregation**
|
|
90
90
|
Aggregate results from partitioned subtasks by validating all partitions completed, merging compatible results, and summarizing if still too large.
|
|
@@ -3,7 +3,7 @@ description: ⚡ No research. Only scout, plan & implement ["trust me bro"]
|
|
|
3
3
|
argument-hint: [tasks-or-prompt]
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
Think harder to plan & start working on these tasks follow the Orchestration Protocol, Core Responsibilities,
|
|
6
|
+
Think harder to plan & start working on these tasks follow the Orchestration Protocol, Core Responsibilities, Task Agents Team and Development Rules:
|
|
7
7
|
<tasks>$ARGUMENTS</tasks>
|
|
8
8
|
|
|
9
9
|
---
|
|
@@ -21,6 +21,6 @@ Think harder to plan & start working on these tasks follow the Orchestration Pro
|
|
|
21
21
|
|
|
22
22
|
## Workflow:
|
|
23
23
|
|
|
24
|
-
- **Scout**: Use
|
|
25
|
-
- **Plan**: Trigger slash command `/plan:fast <detailed-instruction-prompt>` to create an implementation plan based on the reports from
|
|
24
|
+
- **Scout**: Use a Task agent for scouting: Task(subagent_type="general-purpose", prompt="You are a scout. Find related resources, documents, and code snippets in the current codebase.", description="Scout codebase") to find related resources, documents, and code snippets in the current codebase.
|
|
25
|
+
- **Plan**: Trigger slash command `/plan:fast <detailed-instruction-prompt>` to create an implementation plan based on the reports from the Task agent for scouting.
|
|
26
26
|
- **Implementation**: Trigger slash command `/code "skip code review step" <plan-path-name>` to implement the plan.
|
|
@@ -10,7 +10,7 @@ argument-hint: [tasks]
|
|
|
10
10
|
## Workflow
|
|
11
11
|
|
|
12
12
|
### 1. Research (Optional)
|
|
13
|
-
- Use max 2
|
|
13
|
+
- Use max 2 Task agents for research in parallel if tasks complex
|
|
14
14
|
- Use `/scout:ext` to search codebase
|
|
15
15
|
- Keep reports ≤150 lines
|
|
16
16
|
|
|
@@ -20,30 +20,30 @@ argument-hint: [tasks]
|
|
|
20
20
|
|
|
21
21
|
### 3. Parallel Implementation
|
|
22
22
|
- Read `plan.md` for dependency graph
|
|
23
|
-
- Launch multiple
|
|
24
|
-
- Example: "Phases 1-3 parallel" → launch 3 agents simultaneously
|
|
23
|
+
- Launch multiple Task agents for fullstack development in PARALLEL for concurrent phases
|
|
24
|
+
- Example: "Phases 1-3 parallel" → launch 3 Task agents simultaneously
|
|
25
25
|
- Pass phase file path: `{plan-dir}/phase-XX-*.md`
|
|
26
26
|
- Include environment info
|
|
27
27
|
- Wait for all parallel phases complete before dependent phases
|
|
28
28
|
- Sequential phases: launch one agent at a time
|
|
29
29
|
|
|
30
30
|
### 4. Testing
|
|
31
|
-
- Use
|
|
31
|
+
- Use a Task agent for testing for full test suite
|
|
32
32
|
- NO fake data/mocks/cheats
|
|
33
|
-
- If fail: use
|
|
33
|
+
- If fail: use Task agent for debugging, fix, repeat
|
|
34
34
|
|
|
35
35
|
### 5. Code Review
|
|
36
|
-
- Use
|
|
36
|
+
- Use Task agent for code review for all changes
|
|
37
37
|
- If critical issues: fix, retest
|
|
38
38
|
|
|
39
39
|
### 6. Project Management & Docs
|
|
40
|
-
- If approved: use
|
|
40
|
+
- If approved: use Task agent for project management + Task agent for documentation in parallel
|
|
41
41
|
- Update plan files, docs, roadmap
|
|
42
42
|
- If rejected: fix and repeat
|
|
43
43
|
|
|
44
44
|
### 7. Final Report
|
|
45
45
|
- Summary of all parallel phases
|
|
46
46
|
- Guide to get started
|
|
47
|
-
- Ask to commit (use
|
|
47
|
+
- Ask to commit (use Task agent for git operations if yes)
|
|
48
48
|
|
|
49
|
-
**Example:** Phases 1-3 parallel → Launch 3
|
|
49
|
+
**Example:** Phases 1-3 parallel → Launch 3 Task agents for fullstack development → Wait → Phase 4 sequential
|
|
@@ -3,7 +3,7 @@ description: ⚡⚡ Implement a feature automatically ("trust me bro")
|
|
|
3
3
|
argument-hint: [tasks]
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
**Ultrathink** to plan & start working on these tasks follow the Orchestration Protocol, Core Responsibilities,
|
|
6
|
+
**Ultrathink** to plan & start working on these tasks follow the Orchestration Protocol, Core Responsibilities, Task Agents Team and Development Rules:
|
|
7
7
|
<tasks>$ARGUMENTS</tasks>
|
|
8
8
|
|
|
9
9
|
**IMPORTANT:** Analyze the list of skills at `.claude/skills/*` and intelligently activate the skills that are needed for the task during the process.
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
description:
|
|
2
|
+
description: Quick Feature — Rapid feature implementation
|
|
3
3
|
version: "1.0"
|
|
4
4
|
category: engineering
|
|
5
5
|
execution-mode: execute
|
|
@@ -13,30 +13,7 @@ execution-mode: execute
|
|
|
13
13
|
|
|
14
14
|
---
|
|
15
15
|
|
|
16
|
-
##
|
|
17
|
-
|
|
18
|
-
**LOAD now** (in order; path `./rules/` or `~/.{TOOL}/skills/agent-assistant/rules/`):
|
|
19
|
-
|
|
20
|
-
1. ORCHESTRATION-LAWS.md
|
|
21
|
-
2. ADAPTIVE-EXECUTION.md
|
|
22
|
-
3. EXECUTION-PROTOCOL.md
|
|
23
|
-
|
|
24
|
-
**⛔ Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
|
|
25
|
-
|
|
26
|
-
---
|
|
27
|
-
|
|
28
|
-
## 🔀 TIERED EXECUTION
|
|
29
|
-
|
|
30
|
-
| Tier | When | Action |
|
|
31
|
-
| ---------- | ------------------ | ---------------------------- |
|
|
32
|
-
| **TIER 1** | runSubagent EXISTS | Invoke sub-agent (MANDATORY) |
|
|
33
|
-
| **TIER 2** | Tool MISSING | EMBODY agent file (FALLBACK) |
|
|
34
|
-
|
|
35
|
-
**❌ Anti-Lazy**: Never use TIER 2 when TIER 1 tool available.
|
|
36
|
-
|
|
37
|
-
---
|
|
38
|
-
|
|
39
|
-
## 📁 PRIOR PLAN CHECK
|
|
16
|
+
## PRIOR PLAN CHECK
|
|
40
17
|
|
|
41
18
|
```
|
|
42
19
|
IF ./reports/plans/PLAN-{feature}.md exists:
|
|
@@ -49,38 +26,52 @@ Any files in `./reports/` or `./documents/` → English only.
|
|
|
49
26
|
|
|
50
27
|
---
|
|
51
28
|
|
|
52
|
-
##
|
|
29
|
+
## Execution
|
|
53
30
|
|
|
54
|
-
One phase at a time,
|
|
31
|
+
One phase at a time, sequential. Each phase must complete before next begins.
|
|
55
32
|
|
|
56
33
|
---
|
|
57
34
|
|
|
58
|
-
##
|
|
35
|
+
## Phase 1: CONTEXT SCAN
|
|
36
|
+
|
|
37
|
+
| Attribute | Value |
|
|
38
|
+
| --------- | --------------------------------------------- |
|
|
39
|
+
| **Role** | `scouter` |
|
|
40
|
+
| **Goal** | Quick context gathering |
|
|
41
|
+
| **Exit** | Patterns found, integration points identified |
|
|
42
|
+
|
|
43
|
+
### Delegation
|
|
59
44
|
|
|
60
|
-
|
|
61
|
-
| ----- | --------------------------------------------- |
|
|
62
|
-
| Goal | Quick context gathering |
|
|
63
|
-
| Exit | Patterns found, integration points identified |
|
|
45
|
+
> Task(subagent_type="general-purpose", prompt="You are a scouter. Perform quick context gathering for the feature. Exit when: patterns found, integration points identified.", description="scouter: Quick context gathering")
|
|
64
46
|
|
|
65
47
|
---
|
|
66
48
|
|
|
67
|
-
##
|
|
49
|
+
## Phase 2: MICRO-PLANNING
|
|
68
50
|
|
|
69
|
-
|
|
|
70
|
-
|
|
|
71
|
-
|
|
|
72
|
-
|
|
|
51
|
+
| Attribute | Value |
|
|
52
|
+
| --------- | ---------------------------------- |
|
|
53
|
+
| **Role** | `planner` |
|
|
54
|
+
| **Goal** | Quick implementation checklist |
|
|
55
|
+
| **Exit** | Steps identified, approach defined |
|
|
56
|
+
|
|
57
|
+
### Delegation
|
|
58
|
+
|
|
59
|
+
> Task(subagent_type="general-purpose", prompt="You are a planner. Create a quick implementation checklist for the feature. Exit when: steps identified, approach defined.", description="planner: Quick implementation checklist")
|
|
73
60
|
|
|
74
61
|
---
|
|
75
62
|
|
|
76
|
-
##
|
|
63
|
+
## Phase 3: IMPLEMENTATION
|
|
64
|
+
|
|
65
|
+
| Attribute | Value |
|
|
66
|
+
| ---------------- | --------------------------------------------------------------------- |
|
|
67
|
+
| **Role** | Route by domain: UI → `frontend-engineer`, API → `backend-engineer`, DB → `database-architect` |
|
|
68
|
+
| **Prerequisite** | READ `./reports/plans/PLAN-{feature}.md` if exists |
|
|
69
|
+
| **Goal** | Implement feature |
|
|
70
|
+
| **Exit** | Feature implemented, code compiles, basic testing done |
|
|
71
|
+
|
|
72
|
+
### Delegation
|
|
77
73
|
|
|
78
|
-
|
|
79
|
-
| ------------ | ----------------------------------------------------------------------------- |
|
|
80
|
-
| Route | UI → `frontend-engineer`, API → `backend-engineer`, DB → `database-architect` |
|
|
81
|
-
| Prerequisite | READ `./reports/plans/PLAN-{feature}.md` if exists |
|
|
82
|
-
| Goal | Implement feature |
|
|
83
|
-
| Exit | Feature implemented, code compiles, basic testing done |
|
|
74
|
+
> Task(subagent_type="general-purpose", prompt="You are a domain engineer (frontend, backend, or database as appropriate). Implement the feature following existing patterns. READ plan file if exists. Exit when: feature implemented, code compiles, basic testing done.", description="engineer: Implement feature")
|
|
84
75
|
|
|
85
76
|
---
|
|
86
77
|
|
|
@@ -98,6 +89,6 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
|
|
|
98
89
|
|
|
99
90
|
Present feature with:
|
|
100
91
|
|
|
101
|
-
1.
|
|
102
|
-
2.
|
|
103
|
-
3.
|
|
92
|
+
1. **Done** — Feature complete
|
|
93
|
+
2. **Test** → `/test`
|
|
94
|
+
3. **Docs** → `/docs:core`
|
|
@@ -13,34 +13,9 @@ execution-mode: execute
|
|
|
13
13
|
|
|
14
14
|
---
|
|
15
15
|
|
|
16
|
-
## 🛑 PRE-FLIGHT (DO FIRST — BLOCKS PHASE 1)
|
|
17
|
-
|
|
18
|
-
**LOAD now** (in order; path `./rules/` or `~/.{TOOL}/skills/agent-assistant/rules/`):
|
|
19
|
-
|
|
20
|
-
1. ORCHESTRATION-LAWS.md
|
|
21
|
-
2. ADAPTIVE-EXECUTION.md
|
|
22
|
-
3. EXECUTION-PROTOCOL.md
|
|
23
|
-
|
|
24
|
-
**⛔ Do not run Phase 1 until all are loaded.** Follow **all** rules in those files; they override any conflicting instructions in this file.
|
|
25
|
-
|
|
26
|
-
---
|
|
27
|
-
|
|
28
|
-
## 🔀 TIERED EXECUTION
|
|
29
|
-
|
|
30
|
-
> Reference: `{RULES_PATH}/ADAPTIVE-EXECUTION.md`
|
|
31
|
-
|
|
32
|
-
| Tier | When | Action |
|
|
33
|
-
| ---------- | ----------------------------- | ---------------------------- |
|
|
34
|
-
| **TIER 1** | runSubagent/Agent Tool EXISTS | Invoke sub-agent (MANDATORY) |
|
|
35
|
-
| **TIER 2** | Tool MISSING or SYSTEM error | EMBODY agent file (FALLBACK) |
|
|
36
|
-
|
|
37
|
-
**❌ Anti-Lazy**: Never use TIER 2 when TIER 1 tool available.
|
|
38
|
-
|
|
39
|
-
---
|
|
40
|
-
|
|
41
16
|
## 📁 DELIVERABLE FILES
|
|
42
17
|
|
|
43
|
-
|
|
|
18
|
+
| Role | Output |
|
|
44
19
|
| ------------ | ----------------------------------------------- |
|
|
45
20
|
| brainstormer | `./reports/brainstorms/BRAINSTORM-{feature}.md` |
|
|
46
21
|
| researcher | `./reports/researchers/RESEARCH-{feature}.md` |
|
|
@@ -70,77 +45,99 @@ All files in `./reports/` → English only.
|
|
|
70
45
|
|
|
71
46
|
---
|
|
72
47
|
|
|
73
|
-
## ⛔ INCREMENTAL EXECUTION (MANDATORY)
|
|
74
|
-
|
|
75
|
-
One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in one reply. No batching (load only what each phase needs). **Within each phase:** when doing a part, output it in format so user sees what’s happening (announce before doing). Format: rules/EXECUTION-PROTOCOL.md § Phase output structure.
|
|
76
|
-
|
|
77
|
-
---
|
|
78
|
-
|
|
79
48
|
## 🎭 Phase 1: REQUIREMENTS CLARIFICATION
|
|
80
49
|
|
|
81
|
-
|
|
|
50
|
+
| Role | `brainstormer` |
|
|
82
51
|
| ----- | -------------------------------------------------------------------- |
|
|
83
52
|
| Goal | Full requirements discovery |
|
|
84
53
|
| Exit | Requirements clear, constraints identified, success criteria defined |
|
|
85
54
|
|
|
55
|
+
### Delegation
|
|
56
|
+
|
|
57
|
+
> Task(subagent_type="general-purpose", prompt="You are a brainstormer. Full requirements discovery. [See exit criteria above]", description="brainstormer")
|
|
58
|
+
|
|
86
59
|
---
|
|
87
60
|
|
|
88
61
|
## 🎭 Phase 2: RESEARCH
|
|
89
62
|
|
|
90
|
-
|
|
|
63
|
+
| Role | `researcher` |
|
|
91
64
|
| ----- | -------------------------------------------------------------------------- |
|
|
92
65
|
| Goal | Research best practices and patterns |
|
|
93
66
|
| Exit | Patterns researched, best practices identified, recommendations documented |
|
|
94
67
|
|
|
68
|
+
### Delegation
|
|
69
|
+
|
|
70
|
+
> Task(subagent_type="general-purpose", prompt="You are a researcher. Research best practices and patterns. [See exit criteria above]", description="researcher")
|
|
71
|
+
|
|
95
72
|
---
|
|
96
73
|
|
|
97
74
|
## 🎭 Phase 3: CODEBASE ANALYSIS
|
|
98
75
|
|
|
99
|
-
|
|
|
76
|
+
| Role | `scouter` |
|
|
100
77
|
| ----- | ----------------------------------------------------------------------- |
|
|
101
78
|
| Goal | Map architecture and integration points |
|
|
102
79
|
| Exit | Architecture understood, integration points mapped, patterns documented |
|
|
103
80
|
|
|
81
|
+
### Delegation
|
|
82
|
+
|
|
83
|
+
> Task(subagent_type="general-purpose", prompt="You are a scouter. Map architecture and integration points. [See exit criteria above]", description="scouter")
|
|
84
|
+
|
|
104
85
|
---
|
|
105
86
|
|
|
106
87
|
## 🎭 Phase 3.5: DATABASE DESIGN (IF DATA CHANGES)
|
|
107
88
|
|
|
108
|
-
|
|
|
89
|
+
| Role | `database-architect` |
|
|
109
90
|
| ------- | ----------------------------------------------------------- |
|
|
110
91
|
| Trigger | Feature involves database changes/migrations |
|
|
111
92
|
| Goal | Schema design and data modeling |
|
|
112
93
|
| Exit | Schema designed, migrations planned, query patterns defined |
|
|
113
94
|
|
|
95
|
+
### Delegation
|
|
96
|
+
|
|
97
|
+
> Task(subagent_type="general-purpose", prompt="You are a database-architect. Schema design and data modeling. [See exit criteria above]", description="database-architect")
|
|
98
|
+
|
|
114
99
|
---
|
|
115
100
|
|
|
116
101
|
## 🎭 Phase 4: DESIGN (IF UI NEEDED)
|
|
117
102
|
|
|
118
|
-
|
|
|
103
|
+
| Role | `designer` |
|
|
119
104
|
| ------- | ----------------------------------------------------- |
|
|
120
105
|
| Trigger | Feature has UI components |
|
|
121
106
|
| Goal | UI/UX design |
|
|
122
107
|
| Exit | Design created, accessibility considered, specs ready |
|
|
123
108
|
|
|
109
|
+
### Delegation
|
|
110
|
+
|
|
111
|
+
> Task(subagent_type="general-purpose", prompt="You are a designer. UI/UX design. [See exit criteria above]", description="designer")
|
|
112
|
+
|
|
124
113
|
---
|
|
125
114
|
|
|
126
115
|
## 🎭 Phase 5: PLANNING
|
|
127
116
|
|
|
128
|
-
|
|
|
117
|
+
| Role | `planner` |
|
|
129
118
|
| ------------ | --------------------------------------------------- |
|
|
130
119
|
| Prerequisite | **READ** RESEARCH + SCOUT + DESIGN files |
|
|
131
120
|
| Goal | Create detailed implementation plan |
|
|
132
121
|
| Output | `./reports/plans/PLAN-{feature}.md` |
|
|
133
122
|
| Exit | Plan file created, phases defined, risks identified |
|
|
134
123
|
|
|
124
|
+
### Delegation
|
|
125
|
+
|
|
126
|
+
> Task(subagent_type="general-purpose", prompt="You are a planner. READ RESEARCH + SCOUT + DESIGN files. Create detailed implementation plan. [See exit criteria above]", description="planner")
|
|
127
|
+
|
|
135
128
|
---
|
|
136
129
|
|
|
137
130
|
## 🎭 Phase 6: IMPLEMENTATION
|
|
138
131
|
|
|
139
|
-
|
|
|
132
|
+
| Role | `tech-lead` → routes to specialists |
|
|
140
133
|
| ------------ | ------------------------------------------------------- |
|
|
141
134
|
| Prerequisite | **READ and FOLLOW** `./reports/plans/PLAN-{feature}.md` |
|
|
142
135
|
| Goal | Execute implementation plan |
|
|
143
136
|
|
|
137
|
+
### Delegation
|
|
138
|
+
|
|
139
|
+
> Task(subagent_type="general-purpose", prompt="You are a tech-lead. READ and FOLLOW the PLAN file. Execute implementation plan. [See exit criteria below]", description="tech-lead")
|
|
140
|
+
|
|
144
141
|
**STRICT ADHERENCE:**
|
|
145
142
|
|
|
146
143
|
```
|
|
@@ -159,11 +156,15 @@ One phase at a time, each phase independent: Phase 1 → then Phase 2 → … in
|
|
|
159
156
|
|
|
160
157
|
## 🎭 Phase 7: TESTING
|
|
161
158
|
|
|
162
|
-
|
|
|
159
|
+
| Role | `tester` |
|
|
163
160
|
| ------------ | ---------------------------- |
|
|
164
161
|
| Prerequisite | **READ** PLAN + Code changes |
|
|
165
162
|
| Goal | Comprehensive testing |
|
|
166
163
|
|
|
164
|
+
### Delegation
|
|
165
|
+
|
|
166
|
+
> Task(subagent_type="general-purpose", prompt="You are a tester. READ PLAN + Code changes. Comprehensive testing with plan checkpoint verification. [See exit criteria below]", description="tester")
|
|
167
|
+
|
|
167
168
|
**PLAN CHECKPOINT VERIFICATION:**
|
|
168
169
|
|
|
169
170
|
```
|
|
@@ -178,11 +179,15 @@ FOR EACH checkpoint in PLAN:
|
|
|
178
179
|
|
|
179
180
|
## 🎭 Phase 8: REVIEW
|
|
180
181
|
|
|
181
|
-
|
|
|
182
|
+
| Role | `reviewer` |
|
|
182
183
|
| ------------ | -------------------------------- |
|
|
183
184
|
| Prerequisite | **READ** PLAN + Code + Tests |
|
|
184
185
|
| Goal | Quality review + Plan compliance |
|
|
185
186
|
|
|
187
|
+
### Delegation
|
|
188
|
+
|
|
189
|
+
> Task(subagent_type="general-purpose", prompt="You are a reviewer. READ PLAN + Code + Tests. Quality review and plan compliance check. [See exit criteria below]", description="reviewer")
|
|
190
|
+
|
|
186
191
|
**REVIEW CHECKLIST:**
|
|
187
192
|
|
|
188
193
|
- Does code implement plan specification?
|
package/merged-commands/cook.md
CHANGED
|
@@ -3,14 +3,14 @@ description: ⚡⚡⚡ Implement a feature [step by step]
|
|
|
3
3
|
argument-hint: [tasks]
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
Think harder to plan & start working on these tasks follow the Orchestration Protocol, Core Responsibilities,
|
|
6
|
+
Think harder to plan & start working on these tasks follow the Orchestration Protocol, Core Responsibilities, Task Agents Team and Development Rules:
|
|
7
7
|
<tasks>$ARGUMENTS</tasks>
|
|
8
8
|
|
|
9
9
|
---
|
|
10
10
|
|
|
11
11
|
## Role Responsibilities
|
|
12
12
|
- You are an elite software engineering expert who specializes in system architecture design and technical decision-making.
|
|
13
|
-
- Your core mission is to collaborate with users to find the best possible solutions while maintaining brutal honesty about feasibility and trade-offs, then collaborate with your
|
|
13
|
+
- Your core mission is to collaborate with users to find the best possible solutions while maintaining brutal honesty about feasibility and trade-offs, then collaborate with your Task agents to implement the plan.
|
|
14
14
|
- You operate by the holy trinity of software engineering: **YAGNI** (You Aren't Gonna Need It), **KISS** (Keep It Simple, Stupid), and **DRY** (Don't Repeat Yourself). Every solution you propose must honor these principles.
|
|
15
15
|
|
|
16
16
|
---
|
|
@@ -41,13 +41,13 @@ Think harder to plan & start working on these tasks follow the Orchestration Pro
|
|
|
41
41
|
|
|
42
42
|
### Research
|
|
43
43
|
|
|
44
|
-
* Use multiple
|
|
44
|
+
* Use multiple Task agents for research in parallel to explore the user's request, idea validation, challenges, and find the best possible solutions.
|
|
45
45
|
* Keep every research markdown report concise (≤150 lines) while covering all requested topics and citations.
|
|
46
46
|
* Use `/scout:ext` (preferred) or `/scout` (fallback) slash command to search the codebase for files needed to complete the task
|
|
47
47
|
|
|
48
48
|
### Plan
|
|
49
49
|
|
|
50
|
-
*. Use
|
|
50
|
+
*. Use a Task agent for planning: Task(subagent_type="general-purpose", prompt="You are a planner. Analyze reports from researcher and scout Task agents to create an implementation plan using the progressive disclosure structure:...
|
|
51
51
|
- Create a directory using naming pattern from `## Naming` section.
|
|
52
52
|
- Save the overview access point at `plan.md`, keep it generic, under 80 lines, and list each phase with status/progress and links.
|
|
53
53
|
- For each phase, add `phase-XX-phase-name.md` files containing sections (Context links, Overview with date/priority/statuses, Key Insights, Requirements, Architecture, Related code files, Implementation Steps, Todo list, Success Criteria, Risk Assessment, Security Considerations, Next steps).
|
|
@@ -55,7 +55,7 @@ Think harder to plan & start working on these tasks follow the Orchestration Pro
|
|
|
55
55
|
### Implementation
|
|
56
56
|
|
|
57
57
|
* Use `/code` Slash Command to implement the plan step by step, follow the implementation plan in `./plans` directory.
|
|
58
|
-
* Use
|
|
58
|
+
* Use a Task agent for UI/UX design: Task(subagent_type="general-purpose", prompt="You are a ui-ux-designer. Implement the frontend part follow the design guidelines at ./docs/design-guidelines.md file.", description="Implement frontend UI") to implement the frontend part follow the design guidelines at `./docs/design-guidelines.md` file.
|
|
59
59
|
* Use `ai-multimodal` skill to generate image assets.
|
|
60
60
|
* Use `ai-multimodal` skill to analyze and verify generated assets.
|
|
61
61
|
* Use `media-processing` skill for image editing (crop, resize, remove background) if needed.
|
|
@@ -64,13 +64,13 @@ Think harder to plan & start working on these tasks follow the Orchestration Pro
|
|
|
64
64
|
### Testing
|
|
65
65
|
|
|
66
66
|
* Write the tests for the plan, **make sure you don't use fake data, mocks, cheats, tricks, temporary solutions, just to pass the build or github actions**, tests should be real and cover all possible cases.
|
|
67
|
-
* Use
|
|
68
|
-
* If there are issues or failed tests, use
|
|
67
|
+
* Use a Task agent for testing: Task(subagent_type="general-purpose", prompt="You are a tester. Run the tests, make sure it works, then report back to main agent.", description="Run tests") to run the tests, make sure it works, then report back to main agent.
|
|
68
|
+
* If there are issues or failed tests, use a Task agent for debugging: Task(subagent_type="general-purpose", prompt="You are a debugger. Find the root cause of the issues.", description="Debug failures") to find the root cause of the issues, then ask main agent to fix all of them and
|
|
69
69
|
* Repeat the process until all tests pass or no more issues are reported. Again, do not ignore failed tests or use fake data just to pass the build or github actions.
|
|
70
70
|
|
|
71
71
|
### Code Review
|
|
72
72
|
|
|
73
|
-
* After finishing, delegate to
|
|
73
|
+
* After finishing, delegate to a Task agent for code review: Task(subagent_type="general-purpose", prompt="You are a code-reviewer. Review code.", description="Code review") to review code. If there are critical issues, ask main agent to improve the code and tell the Task agent for testing to run the tests again.
|
|
74
74
|
* Repeat the "Testing" process until all tests pass.
|
|
75
75
|
* When all tests pass, code is reviewed, the tasks are completed, report back to user with a summary of the changes and explain everything briefly, ask user to review the changes and approve them.
|
|
76
76
|
* **IMPORTANT:** Sacrifice grammar for the sake of concision when writing outputs.
|
|
@@ -78,10 +78,10 @@ Think harder to plan & start working on these tasks follow the Orchestration Pro
|
|
|
78
78
|
### Project Management & Documentation
|
|
79
79
|
|
|
80
80
|
**If user approves the changes:**
|
|
81
|
-
* Use
|
|
82
|
-
* Use
|
|
83
|
-
* Use
|
|
84
|
-
* Use
|
|
81
|
+
* Use Task agents for project management and documentation in parallel to update the project progress and documentation:
|
|
82
|
+
* Use a Task agent for project management: Task(subagent_type="general-purpose", prompt="You are a project-manager. Update the project progress and task status in the given plan file.", description="Update project progress") to update the project progress and task status in the given plan file.
|
|
83
|
+
* Use a Task agent for documentation: Task(subagent_type="general-purpose", prompt="You are a docs-manager. Update the docs in ./docs directory if needed.", description="Update docs") to update the docs in `./docs` directory if needed.
|
|
84
|
+
* Use a Task agent for project management: Task(subagent_type="general-purpose", prompt="You are a project-manager. Create a project roadmap at ./docs/project-roadmap.md file.", description="Create roadmap") to create a project roadmap at `./docs/project-roadmap.md` file.
|
|
85
85
|
* **IMPORTANT:** Sacrifice grammar for the sake of concision when writing outputs.
|
|
86
86
|
|
|
87
87
|
**If user rejects the changes:**
|
|
@@ -95,7 +95,7 @@ Think harder to plan & start working on these tasks follow the Orchestration Pro
|
|
|
95
95
|
|
|
96
96
|
### Final Report
|
|
97
97
|
* Report back to user with a summary of the changes and explain everything briefly, guide user to get started and suggest the next steps.
|
|
98
|
-
* Ask the user if they want to commit and push to git repository, if yes, use
|
|
98
|
+
* Ask the user if they want to commit and push to git repository, if yes, use a Task agent for git operations: Task(subagent_type="general-purpose", prompt="You are a git-manager. Commit and push to git repository.", description="Git commit and push") to commit and push to git repository.
|
|
99
99
|
- **IMPORTANT:** Sacrifice grammar for the sake of concision when writing reports.
|
|
100
100
|
- **IMPORTANT:** In reports, list any unresolved questions at the end, if any.
|
|
101
101
|
|
|
@@ -11,7 +11,7 @@ source: community
|
|
|
11
11
|
|
|
12
12
|
# Daily News Report v3.0
|
|
13
13
|
|
|
14
|
-
> **Architecture Upgrade**: Main Agent Orchestration +
|
|
14
|
+
> **Architecture Upgrade**: Main Agent Orchestration + Task Agent Execution + Browser Scraping + Smart Caching
|
|
15
15
|
|
|
16
16
|
## Core Architecture
|
|
17
17
|
|
|
@@ -35,7 +35,7 @@ source: community
|
|
|
35
35
|
└──────────────────────────────────────────────────────────────────────┘
|
|
36
36
|
↓ Dispatch ↑ Return Results
|
|
37
37
|
┌─────────────────────────────────────────────────────────────────────┐
|
|
38
|
-
│
|
|
38
|
+
│ Task Agent Execution Layer │
|
|
39
39
|
├─────────────────────────────────────────────────────────────────────┤
|
|
40
40
|
│ │
|
|
41
41
|
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
|
|
@@ -74,7 +74,7 @@ Steps:
|
|
|
74
74
|
5. Check if a partial report exists for today (append mode)
|
|
75
75
|
```
|
|
76
76
|
|
|
77
|
-
### Phase 2: Dispatch
|
|
77
|
+
### Phase 2: Dispatch Task Agents
|
|
78
78
|
|
|
79
79
|
**Strategy**: Parallel dispatch, batch execution, early stopping mechanism
|
|
80
80
|
|
|
@@ -95,9 +95,9 @@ If still < 20 items:
|
|
|
95
95
|
- Browser Worker: ProductHunt, Latent Space (Require JS rendering)
|
|
96
96
|
```
|
|
97
97
|
|
|
98
|
-
### Phase 3:
|
|
98
|
+
### Phase 3: Task Agent Task Format
|
|
99
99
|
|
|
100
|
-
Task format received by each
|
|
100
|
+
Task format received by each Task Agent:
|
|
101
101
|
|
|
102
102
|
```yaml
|
|
103
103
|
task: fetch_and_extract
|
|
@@ -134,12 +134,12 @@ Main Agent Responsibilities:
|
|
|
134
134
|
|
|
135
135
|
```yaml
|
|
136
136
|
Monitoring:
|
|
137
|
-
- Check
|
|
137
|
+
- Check Task Agent return status (success/partial/failed)
|
|
138
138
|
- Count collected items
|
|
139
139
|
- Record success rate per source
|
|
140
140
|
|
|
141
141
|
Feedback Loop:
|
|
142
|
-
- If a
|
|
142
|
+
- If a Task Agent fails, decide whether to retry or skip
|
|
143
143
|
- If a source fails persistently, mark as disabled
|
|
144
144
|
- Dynamically adjust source selection for subsequent batches
|
|
145
145
|
|
|
@@ -158,7 +158,7 @@ Deduplication:
|
|
|
158
158
|
- Check cache.json to avoid history duplicates
|
|
159
159
|
|
|
160
160
|
Score Calibration:
|
|
161
|
-
- Unify scoring standards across
|
|
161
|
+
- Unify scoring standards across Task Agents
|
|
162
162
|
- Adjust weights based on source credibility
|
|
163
163
|
- Bonus points for manually curated high-quality sources
|
|
164
164
|
|
|
@@ -212,7 +212,7 @@ Update cache.json:
|
|
|
212
212
|
- article_history: Record included articles
|
|
213
213
|
```
|
|
214
214
|
|
|
215
|
-
##
|
|
215
|
+
## Task Agent Call Examples
|
|
216
216
|
|
|
217
217
|
### Using general-purpose Agent
|
|
218
218
|
|
|
@@ -260,7 +260,7 @@ Task Call:
|
|
|
260
260
|
|
|
261
261
|
```
|
|
262
262
|
Task Call:
|
|
263
|
-
subagent_type:
|
|
263
|
+
subagent_type: general-purpose
|
|
264
264
|
prompt: |
|
|
265
265
|
task: fetch_and_extract
|
|
266
266
|
input:
|
|
@@ -288,7 +288,7 @@ Task Call:
|
|
|
288
288
|
> Curated from N sources today, containing 20 high-quality items
|
|
289
289
|
> Generation Time: X min | Version: v3.0
|
|
290
290
|
>
|
|
291
|
-
> **Warning**:
|
|
291
|
+
> **Warning**: Task agent 'worker' not detected. Running in generic mode (Serial Execution). Performance might be degraded.
|
|
292
292
|
|
|
293
293
|
---
|
|
294
294
|
|
|
@@ -318,11 +318,11 @@ Task Call:
|
|
|
318
318
|
|
|
319
319
|
1. **Quality over Quantity**: Low-quality content does not enter the report.
|
|
320
320
|
2. **Early Stop**: Stop scraping once 20 high-quality items are reached.
|
|
321
|
-
3. **Parallel First**:
|
|
321
|
+
3. **Parallel First**: Task Agents in the same batch execute in parallel.
|
|
322
322
|
4. **Fault Tolerance**: Failure of a single source does not affect the whole process.
|
|
323
323
|
5. **Cache Reuse**: Avoid re-scraping the same content.
|
|
324
324
|
6. **Main Agent Control**: All decisions are made by the Main Agent.
|
|
325
|
-
7. **Fallback Awareness**: Detect
|
|
325
|
+
7. **Fallback Awareness**: Detect Task agent availability, gracefully degrade if unavailable.
|
|
326
326
|
|
|
327
327
|
## Expected Performance
|
|
328
328
|
|
|
@@ -336,7 +336,7 @@ Task Call:
|
|
|
336
336
|
|
|
337
337
|
| Error Type | Handling |
|
|
338
338
|
|---|---|
|
|
339
|
-
|
|
|
339
|
+
| Task Agent Timeout | Log error, continue to next |
|
|
340
340
|
| Source 403/404 | Mark disabled, update sources.json |
|
|
341
341
|
| Extraction Failed | Return raw content, Main Agent decides |
|
|
342
342
|
| Browser Crash | Skip source, log entry |
|
|
@@ -346,7 +346,7 @@ Task Call:
|
|
|
346
346
|
To ensure usability across different Agent environments, the following checks must be performed:
|
|
347
347
|
|
|
348
348
|
1. **Environment Check**:
|
|
349
|
-
- In Phase 1 initialization, attempt to detect if `worker`
|
|
349
|
+
- In Phase 1 initialization, attempt to detect if `worker` Task agent exists.
|
|
350
350
|
- If not exists (or plugin not installed), automatically switch to **Serial Execution Mode**.
|
|
351
351
|
|
|
352
352
|
2. **Serial Execution Mode**:
|