oh-my-customcode 0.1.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/LICENSE +21 -0
- package/README.md +287 -0
- package/dist/cli/index.js +13299 -0
- package/dist/index.js +927 -0
- package/package.json +74 -0
- package/templates/.claude/contexts/dev.md +20 -0
- package/templates/.claude/contexts/ecomode.md +63 -0
- package/templates/.claude/contexts/index.yaml +41 -0
- package/templates/.claude/contexts/research.md +28 -0
- package/templates/.claude/contexts/review.md +23 -0
- package/templates/.claude/hooks/hooks.json +185 -0
- package/templates/.claude/hooks/hud/index.yaml +27 -0
- package/templates/.claude/hooks/hud/update-status.sh +32 -0
- package/templates/.claude/hooks/index.yaml +46 -0
- package/templates/.claude/hooks/memory-persistence/pre-compact.sh +37 -0
- package/templates/.claude/hooks/memory-persistence/session-end.sh +64 -0
- package/templates/.claude/hooks/memory-persistence/session-start.sh +41 -0
- package/templates/.claude/hooks/strategic-compact/suggest-compact.sh +50 -0
- package/templates/.claude/install-hooks.sh +100 -0
- package/templates/.claude/rules/MAY-optimization.md +93 -0
- package/templates/.claude/rules/MUST-agent-design.md +107 -0
- package/templates/.claude/rules/MUST-agent-identification.md +108 -0
- package/templates/.claude/rules/MUST-continuous-improvement.md +132 -0
- package/templates/.claude/rules/MUST-intent-transparency.md +199 -0
- package/templates/.claude/rules/MUST-language-policy.md +62 -0
- package/templates/.claude/rules/MUST-orchestrator-coordination.md +266 -0
- package/templates/.claude/rules/MUST-parallel-execution.md +341 -0
- package/templates/.claude/rules/MUST-permissions.md +84 -0
- package/templates/.claude/rules/MUST-safety.md +69 -0
- package/templates/.claude/rules/MUST-sync-verification.md +219 -0
- package/templates/.claude/rules/MUST-tool-identification.md +112 -0
- package/templates/.claude/rules/SHOULD-ecomode.md +145 -0
- package/templates/.claude/rules/SHOULD-error-handling.md +102 -0
- package/templates/.claude/rules/SHOULD-hud-statusline.md +89 -0
- package/templates/.claude/rules/SHOULD-interaction.md +103 -0
- package/templates/.claude/rules/SHOULD-memory-integration.md +114 -0
- package/templates/.claude/rules/SHOULD-pipeline-mode.md +165 -0
- package/templates/.claude/rules/index.yaml +125 -0
- package/templates/.claude/uninstall-hooks.sh +52 -0
- package/templates/CLAUDE.md.en +259 -0
- package/templates/CLAUDE.md.ko +259 -0
- package/templates/agents/index.yaml +237 -0
- package/templates/agents/infra-engineer/aws-expert/AGENT.md +47 -0
- package/templates/agents/infra-engineer/aws-expert/index.yaml +27 -0
- package/templates/agents/infra-engineer/docker-expert/AGENT.md +47 -0
- package/templates/agents/infra-engineer/docker-expert/index.yaml +27 -0
- package/templates/agents/manager/creator/AGENT.md +274 -0
- package/templates/agents/manager/creator/index.yaml +66 -0
- package/templates/agents/manager/gitnerd/AGENT.md +91 -0
- package/templates/agents/manager/gitnerd/index.yaml +55 -0
- package/templates/agents/manager/sauron/AGENT.md +153 -0
- package/templates/agents/manager/sauron/index.yaml +52 -0
- package/templates/agents/manager/supplier/AGENT.md +142 -0
- package/templates/agents/manager/supplier/index.yaml +31 -0
- package/templates/agents/manager/sync-checker/AGENT.md +34 -0
- package/templates/agents/manager/sync-checker/index.yaml +32 -0
- package/templates/agents/manager/updater/AGENT.md +125 -0
- package/templates/agents/manager/updater/index.yaml +31 -0
- package/templates/agents/orchestrator/dev-lead/AGENT.md +116 -0
- package/templates/agents/orchestrator/dev-lead/index.yaml +73 -0
- package/templates/agents/orchestrator/planner/AGENT.md +102 -0
- package/templates/agents/orchestrator/planner/index.yaml +38 -0
- package/templates/agents/orchestrator/qa-lead/AGENT.md +92 -0
- package/templates/agents/orchestrator/qa-lead/index.yaml +40 -0
- package/templates/agents/orchestrator/secretary/AGENT.md +132 -0
- package/templates/agents/orchestrator/secretary/index.yaml +55 -0
- package/templates/agents/qa-team/qa-engineer/AGENT.md +98 -0
- package/templates/agents/qa-team/qa-engineer/index.yaml +59 -0
- package/templates/agents/qa-team/qa-planner/AGENT.md +75 -0
- package/templates/agents/qa-team/qa-planner/index.yaml +47 -0
- package/templates/agents/qa-team/qa-writer/AGENT.md +98 -0
- package/templates/agents/qa-team/qa-writer/index.yaml +44 -0
- package/templates/agents/sw-architect/documenter/AGENT.md +120 -0
- package/templates/agents/sw-architect/documenter/index.yaml +39 -0
- package/templates/agents/sw-architect/speckit-agent/AGENT.md +127 -0
- package/templates/agents/sw-architect/speckit-agent/index.yaml +78 -0
- package/templates/agents/sw-engineer/backend/express-expert/AGENT.md +132 -0
- package/templates/agents/sw-engineer/backend/express-expert/index.yaml +36 -0
- package/templates/agents/sw-engineer/backend/fastapi-expert/AGENT.md +47 -0
- package/templates/agents/sw-engineer/backend/fastapi-expert/index.yaml +27 -0
- package/templates/agents/sw-engineer/backend/go-backend-expert/AGENT.md +47 -0
- package/templates/agents/sw-engineer/backend/go-backend-expert/index.yaml +27 -0
- package/templates/agents/sw-engineer/backend/nestjs-expert/AGENT.md +107 -0
- package/templates/agents/sw-engineer/backend/nestjs-expert/index.yaml +43 -0
- package/templates/agents/sw-engineer/backend/springboot-expert/AGENT.md +103 -0
- package/templates/agents/sw-engineer/backend/springboot-expert/index.yaml +69 -0
- package/templates/agents/sw-engineer/frontend/svelte-agent/AGENT.md +71 -0
- package/templates/agents/sw-engineer/frontend/svelte-agent/index.yaml +41 -0
- package/templates/agents/sw-engineer/frontend/vercel-agent/AGENT.md +67 -0
- package/templates/agents/sw-engineer/frontend/vercel-agent/index.yaml +43 -0
- package/templates/agents/sw-engineer/frontend/vuejs-agent/AGENT.md +71 -0
- package/templates/agents/sw-engineer/frontend/vuejs-agent/index.yaml +48 -0
- package/templates/agents/sw-engineer/language/golang-expert/AGENT.md +47 -0
- package/templates/agents/sw-engineer/language/golang-expert/index.yaml +27 -0
- package/templates/agents/sw-engineer/language/java21-expert/AGENT.md +122 -0
- package/templates/agents/sw-engineer/language/java21-expert/index.yaml +51 -0
- package/templates/agents/sw-engineer/language/kotlin-expert/AGENT.md +47 -0
- package/templates/agents/sw-engineer/language/kotlin-expert/index.yaml +27 -0
- package/templates/agents/sw-engineer/language/python-expert/AGENT.md +47 -0
- package/templates/agents/sw-engineer/language/python-expert/index.yaml +27 -0
- package/templates/agents/sw-engineer/language/rust-expert/AGENT.md +47 -0
- package/templates/agents/sw-engineer/language/rust-expert/index.yaml +27 -0
- package/templates/agents/sw-engineer/language/typescript-expert/AGENT.md +47 -0
- package/templates/agents/sw-engineer/language/typescript-expert/index.yaml +27 -0
- package/templates/agents/sw-engineer/tooling/bun-expert/AGENT.md +73 -0
- package/templates/agents/sw-engineer/tooling/bun-expert/index.yaml +46 -0
- package/templates/agents/sw-engineer/tooling/npm-expert/AGENT.md +160 -0
- package/templates/agents/sw-engineer/tooling/npm-expert/index.yaml +45 -0
- package/templates/agents/sw-engineer/tooling/optimizer/AGENT.md +170 -0
- package/templates/agents/sw-engineer/tooling/optimizer/index.yaml +45 -0
- package/templates/agents/system/memory-keeper/AGENT.md +126 -0
- package/templates/agents/system/memory-keeper/index.yaml +45 -0
- package/templates/agents/system/naggy/AGENT.md +72 -0
- package/templates/agents/system/naggy/index.yaml +35 -0
- package/templates/commands/COMMANDS.md +136 -0
- package/templates/commands/creator/agent.md +121 -0
- package/templates/commands/dev/refactor.md +126 -0
- package/templates/commands/dev/review.md +82 -0
- package/templates/commands/git/branch.yaml +8 -0
- package/templates/commands/git/commit.yaml +4 -0
- package/templates/commands/git/pr.yaml +4 -0
- package/templates/commands/git/status.yaml +4 -0
- package/templates/commands/git/sync.yaml +4 -0
- package/templates/commands/index.yaml +225 -0
- package/templates/commands/intent/explain.md +144 -0
- package/templates/commands/memory/recall.md +164 -0
- package/templates/commands/memory/save.md +128 -0
- package/templates/commands/naggy/add.yaml +8 -0
- package/templates/commands/naggy/done.yaml +8 -0
- package/templates/commands/naggy/list.yaml +4 -0
- package/templates/commands/naggy/priority.yaml +11 -0
- package/templates/commands/naggy/remind.yaml +4 -0
- package/templates/commands/npm/audit.yaml +62 -0
- package/templates/commands/npm/publish.yaml +52 -0
- package/templates/commands/npm/version.yaml +62 -0
- package/templates/commands/optimize/analyze.yaml +34 -0
- package/templates/commands/optimize/bundle.yaml +50 -0
- package/templates/commands/optimize/report.yaml +56 -0
- package/templates/commands/pipeline/list.md +81 -0
- package/templates/commands/pipeline/run.md +127 -0
- package/templates/commands/sauron/quick.yaml +4 -0
- package/templates/commands/sauron/report.yaml +4 -0
- package/templates/commands/sauron/watch.yaml +4 -0
- package/templates/commands/supplier/audit.md +133 -0
- package/templates/commands/supplier/fix.md +121 -0
- package/templates/commands/sync/agents.yaml +4 -0
- package/templates/commands/sync/check.yaml +4 -0
- package/templates/commands/sync/commands.yaml +4 -0
- package/templates/commands/sync/docs.yaml +4 -0
- package/templates/commands/sync/fix.yaml +4 -0
- package/templates/commands/system/help.md +137 -0
- package/templates/commands/system/lists.md +86 -0
- package/templates/commands/system/status.md +163 -0
- package/templates/commands/updater/docs.md +165 -0
- package/templates/commands/updater/external.md +214 -0
- package/templates/guides/aws/common-patterns.md +169 -0
- package/templates/guides/aws/index.yaml +26 -0
- package/templates/guides/aws/well-architected.md +143 -0
- package/templates/guides/claude-code/01-overview.md +42 -0
- package/templates/guides/claude-code/03-tools.md +107 -0
- package/templates/guides/claude-code/04-agent-skills.md +90 -0
- package/templates/guides/claude-code/05-agent-sdk.md +129 -0
- package/templates/guides/claude-code/06-mcp.md +165 -0
- package/templates/guides/claude-code/07-prompt-engineering.md +100 -0
- package/templates/guides/claude-code/08-testing.md +58 -0
- package/templates/guides/claude-code/09-guardrails.md +80 -0
- package/templates/guides/claude-code/10-monitoring.md +89 -0
- package/templates/guides/claude-code/index.yaml +51 -0
- package/templates/guides/docker/compose-best-practices.md +284 -0
- package/templates/guides/docker/dockerfile-best-practices.md +262 -0
- package/templates/guides/docker/index.yaml +26 -0
- package/templates/guides/fastapi/best-practices.md +232 -0
- package/templates/guides/fastapi/index.yaml +21 -0
- package/templates/guides/go-backend/index.yaml +26 -0
- package/templates/guides/go-backend/project-layout.md +243 -0
- package/templates/guides/go-backend/uber-style.md +212 -0
- package/templates/guides/golang/concurrency.md +282 -0
- package/templates/guides/golang/effective-go.md +309 -0
- package/templates/guides/golang/error-handling.md +250 -0
- package/templates/guides/golang/index.yaml +27 -0
- package/templates/guides/index.yaml +101 -0
- package/templates/guides/kotlin/coding-conventions.md +247 -0
- package/templates/guides/kotlin/idioms.md +234 -0
- package/templates/guides/kotlin/index.yaml +26 -0
- package/templates/guides/python/index.yaml +26 -0
- package/templates/guides/python/pep8-style-guide.md +202 -0
- package/templates/guides/python/zen-of-python.md +79 -0
- package/templates/guides/rust/error-handling.md +262 -0
- package/templates/guides/rust/index.yaml +26 -0
- package/templates/guides/rust/ownership.md +180 -0
- package/templates/guides/springboot/best-practices.md +361 -0
- package/templates/guides/springboot/index.yaml +22 -0
- package/templates/guides/typescript/advanced-types.md +225 -0
- package/templates/guides/typescript/index.yaml +26 -0
- package/templates/guides/typescript/type-system.md +219 -0
- package/templates/guides/web-design/accessibility.md +66 -0
- package/templates/guides/web-design/index.yaml +20 -0
- package/templates/guides/web-design/performance.md +102 -0
- package/templates/pipelines/examples/code-review.yaml +66 -0
- package/templates/pipelines/index.yaml +18 -0
- package/templates/pipelines/templates/pipeline-template.yaml +50 -0
- package/templates/skills/backend/fastapi-best-practices/SKILL.md +269 -0
- package/templates/skills/backend/fastapi-best-practices/index.yaml +25 -0
- package/templates/skills/backend/go-backend-best-practices/SKILL.md +337 -0
- package/templates/skills/backend/go-backend-best-practices/index.yaml +26 -0
- package/templates/skills/backend/springboot-best-practices/SKILL.md +356 -0
- package/templates/skills/backend/springboot-best-practices/index.yaml +27 -0
- package/templates/skills/development/go-best-practices/SKILL.md +202 -0
- package/templates/skills/development/go-best-practices/index.yaml +25 -0
- package/templates/skills/development/kotlin-best-practices/SKILL.md +255 -0
- package/templates/skills/development/kotlin-best-practices/index.yaml +27 -0
- package/templates/skills/development/python-best-practices/SKILL.md +221 -0
- package/templates/skills/development/python-best-practices/index.yaml +25 -0
- package/templates/skills/development/react-best-practices/SKILL.md +100 -0
- package/templates/skills/development/react-best-practices/index.yaml +39 -0
- package/templates/skills/development/rust-best-practices/SKILL.md +266 -0
- package/templates/skills/development/rust-best-practices/index.yaml +26 -0
- package/templates/skills/development/typescript-best-practices/SKILL.md +320 -0
- package/templates/skills/development/typescript-best-practices/index.yaml +28 -0
- package/templates/skills/development/vercel-deploy/SKILL.md +73 -0
- package/templates/skills/development/vercel-deploy/index.yaml +30 -0
- package/templates/skills/development/web-design-guidelines/SKILL.md +117 -0
- package/templates/skills/development/web-design-guidelines/index.yaml +34 -0
- package/templates/skills/index.yaml +129 -0
- package/templates/skills/infrastructure/aws-best-practices/SKILL.md +279 -0
- package/templates/skills/infrastructure/aws-best-practices/index.yaml +27 -0
- package/templates/skills/infrastructure/docker-best-practices/SKILL.md +274 -0
- package/templates/skills/infrastructure/docker-best-practices/index.yaml +26 -0
- package/templates/skills/orchestration/intent-detection/SKILL.md +214 -0
- package/templates/skills/orchestration/intent-detection/index.yaml +30 -0
- package/templates/skills/orchestration/intent-detection/patterns/agent-triggers.yaml +333 -0
- package/templates/skills/orchestration/pipeline-execution/SKILL.md +188 -0
- package/templates/skills/orchestration/pipeline-execution/index.yaml +27 -0
- package/templates/skills/system/memory-management/SKILL.md +194 -0
- package/templates/skills/system/memory-management/index.yaml +30 -0
- package/templates/skills/system/result-aggregation/SKILL.md +163 -0
- package/templates/skills/system/result-aggregation/index.yaml +36 -0
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
# [SHOULD] Interaction Rules
|
|
2
|
+
|
|
3
|
+
> **Priority**: SHOULD - Strongly recommended
|
|
4
|
+
> **Exception**: Emergency or explicit user request
|
|
5
|
+
|
|
6
|
+
## Response Principles
|
|
7
|
+
|
|
8
|
+
### 1. Brevity
|
|
9
|
+
```
|
|
10
|
+
✓ Key information first
|
|
11
|
+
✓ Skip unnecessary preamble
|
|
12
|
+
✓ Answer only what's asked
|
|
13
|
+
✗ Over-explanation
|
|
14
|
+
✗ Repetitive confirmation
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
### 2. Clarity
|
|
18
|
+
```
|
|
19
|
+
✓ Specific expressions
|
|
20
|
+
✓ Unambiguous instructions
|
|
21
|
+
✓ Executable code format
|
|
22
|
+
✗ Abstract descriptions only
|
|
23
|
+
✗ Overuse of "maybe", "probably"
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
### 3. Transparency
|
|
27
|
+
```
|
|
28
|
+
✓ State actions performed
|
|
29
|
+
✓ Report changes
|
|
30
|
+
✓ Acknowledge uncertainty
|
|
31
|
+
✗ Hide actions
|
|
32
|
+
✗ Present guesses as facts
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
## Status Report Format
|
|
36
|
+
|
|
37
|
+
### Start
|
|
38
|
+
```
|
|
39
|
+
[Start] {task name}
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
### In Progress
|
|
43
|
+
```
|
|
44
|
+
[Progress] {current step} ({n}/{total})
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
### Complete
|
|
48
|
+
```
|
|
49
|
+
[Done] {task name}
|
|
50
|
+
Result: {summary}
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
### Failed
|
|
54
|
+
```
|
|
55
|
+
[Failed] {task name}
|
|
56
|
+
Cause: {reason}
|
|
57
|
+
Alternative: {possible solutions}
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
## Handling Requests
|
|
61
|
+
|
|
62
|
+
### Clear Request
|
|
63
|
+
→ Execute immediately
|
|
64
|
+
|
|
65
|
+
### Ambiguous Request
|
|
66
|
+
```
|
|
67
|
+
[Confirm]
|
|
68
|
+
Understood "{request}" as {interpretation}.
|
|
69
|
+
|
|
70
|
+
Proceed?
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
### Risky Request
|
|
74
|
+
```
|
|
75
|
+
[Warning]
|
|
76
|
+
This action has {risk factor}.
|
|
77
|
+
|
|
78
|
+
Continue?
|
|
79
|
+
- Yes: {action to perform}
|
|
80
|
+
- No: Cancel
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
## Multiple Tasks
|
|
84
|
+
|
|
85
|
+
### Order
|
|
86
|
+
1. Dependent tasks: Sequential
|
|
87
|
+
2. Independent tasks: Parallel allowed
|
|
88
|
+
|
|
89
|
+
### Report
|
|
90
|
+
```
|
|
91
|
+
[Task 1/3] Done - {result}
|
|
92
|
+
[Task 2/3] In progress...
|
|
93
|
+
[Task 3/3] Pending
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
## Long-running Tasks
|
|
97
|
+
|
|
98
|
+
```
|
|
99
|
+
[In Progress] {task name}
|
|
100
|
+
Elapsed: {time}
|
|
101
|
+
Current: {step}
|
|
102
|
+
Remaining: {work left}
|
|
103
|
+
```
|
|
@@ -0,0 +1,114 @@
|
|
|
1
|
+
# [SHOULD] Memory Integration Rules
|
|
2
|
+
|
|
3
|
+
> **Priority**: SHOULD - Recommended for context persistence
|
|
4
|
+
> **ID**: R011
|
|
5
|
+
|
|
6
|
+
## Purpose
|
|
7
|
+
|
|
8
|
+
Integrate claude-mem for session context persistence across compaction.
|
|
9
|
+
|
|
10
|
+
## Requirements
|
|
11
|
+
|
|
12
|
+
### 1. Save Before Compaction
|
|
13
|
+
```yaml
|
|
14
|
+
trigger: PreCompact hook
|
|
15
|
+
action:
|
|
16
|
+
- Collect session context (tasks, decisions, key info)
|
|
17
|
+
- Format with project tag "baekgom-agents"
|
|
18
|
+
- Store in claude-mem with metadata
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
### 2. Restore on Session Start
|
|
22
|
+
```yaml
|
|
23
|
+
trigger: SessionStart hook
|
|
24
|
+
action:
|
|
25
|
+
- Build semantic query with project prefix
|
|
26
|
+
- Search claude-mem for relevant context
|
|
27
|
+
- Load and present context to agent
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
### 3. Project Isolation
|
|
31
|
+
```yaml
|
|
32
|
+
rule: Always include project name in queries
|
|
33
|
+
reason: Prevent cross-contamination between projects
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
## Storage Format
|
|
37
|
+
|
|
38
|
+
```yaml
|
|
39
|
+
project: baekgom-agents
|
|
40
|
+
session: {date}-{uuid}
|
|
41
|
+
tags: [session, task, decision]
|
|
42
|
+
content:
|
|
43
|
+
summary: Brief description of session context
|
|
44
|
+
tasks_completed: List of completed tasks
|
|
45
|
+
decisions: Key decisions made
|
|
46
|
+
open_items: Unfinished work
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
## Query Pattern
|
|
50
|
+
|
|
51
|
+
Always include project name in queries:
|
|
52
|
+
- `"baekgom-agents session authentication"`
|
|
53
|
+
- `"baekgom-agents 2025-01-24 bug fix"`
|
|
54
|
+
- `"baekgom-agents agent creation workflow"`
|
|
55
|
+
|
|
56
|
+
### Effective Queries
|
|
57
|
+
```yaml
|
|
58
|
+
good:
|
|
59
|
+
- "baekgom-agents implementing oauth" (semantic, project-scoped)
|
|
60
|
+
- "baekgom-agents 2025-01-24 memory system" (temporal)
|
|
61
|
+
- "baekgom-agents decision agent architecture" (topic-based)
|
|
62
|
+
|
|
63
|
+
bad:
|
|
64
|
+
- "implementing oauth" (missing project scope)
|
|
65
|
+
- "session context" (too generic)
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
## Commands
|
|
69
|
+
|
|
70
|
+
| Command | Description |
|
|
71
|
+
|---------|-------------|
|
|
72
|
+
| `memory:save` | Save current context to claude-mem |
|
|
73
|
+
| `memory:recall` | Search and recall relevant memories |
|
|
74
|
+
|
|
75
|
+
## Integration with Agents
|
|
76
|
+
|
|
77
|
+
### memory-keeper Agent
|
|
78
|
+
```
|
|
79
|
+
Responsible for:
|
|
80
|
+
- Executing save/recall operations
|
|
81
|
+
- Managing session metadata
|
|
82
|
+
- Handling PreCompact and SessionStart hooks
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
### Other Agents
|
|
86
|
+
```
|
|
87
|
+
When to trigger memory:save:
|
|
88
|
+
- Before complex task completion
|
|
89
|
+
- When making significant decisions
|
|
90
|
+
- Before expected context compaction
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
## Storage Provider
|
|
94
|
+
|
|
95
|
+
```yaml
|
|
96
|
+
provider: claude-mem
|
|
97
|
+
collection: claude_memories
|
|
98
|
+
project_tag: baekgom-agents
|
|
99
|
+
archive_path: ~/.claude-mem/archives/
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
## Error Handling
|
|
103
|
+
|
|
104
|
+
```yaml
|
|
105
|
+
on_save_failure:
|
|
106
|
+
- Log error
|
|
107
|
+
- Continue without blocking main task
|
|
108
|
+
- Notify user of memory save failure
|
|
109
|
+
|
|
110
|
+
on_recall_failure:
|
|
111
|
+
- Log error
|
|
112
|
+
- Continue with available context
|
|
113
|
+
- Notify user that memory recall failed
|
|
114
|
+
```
|
|
@@ -0,0 +1,165 @@
|
|
|
1
|
+
# [SHOULD] Pipeline Mode Rules
|
|
2
|
+
|
|
3
|
+
> **Priority**: SHOULD - Recommended for sequential workflows
|
|
4
|
+
> **ID**: R014
|
|
5
|
+
|
|
6
|
+
## Purpose
|
|
7
|
+
|
|
8
|
+
Enable declarative, sequential multi-step workflows with variable passing between steps.
|
|
9
|
+
|
|
10
|
+
## Pipeline Definition Format
|
|
11
|
+
|
|
12
|
+
```yaml
|
|
13
|
+
name: pipeline-name
|
|
14
|
+
description: What this pipeline does
|
|
15
|
+
|
|
16
|
+
inputs:
|
|
17
|
+
- name: input_name
|
|
18
|
+
required: true
|
|
19
|
+
description: Input description
|
|
20
|
+
|
|
21
|
+
steps:
|
|
22
|
+
- id: step_1
|
|
23
|
+
agent: agent-name
|
|
24
|
+
action: action_name
|
|
25
|
+
input: { key: "${input_name}" }
|
|
26
|
+
output: result_variable
|
|
27
|
+
|
|
28
|
+
- id: step_2
|
|
29
|
+
agent: another-agent
|
|
30
|
+
action: action_name
|
|
31
|
+
input: { data: "${result_variable}" }
|
|
32
|
+
output: final_result
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
## Variable Syntax
|
|
36
|
+
|
|
37
|
+
- `${variable}`: Reference input or previous step output
|
|
38
|
+
- `${step_id.field}`: Reference specific field from step output
|
|
39
|
+
- `${inputs.name}`: Explicit input reference
|
|
40
|
+
|
|
41
|
+
## Execution Rules
|
|
42
|
+
|
|
43
|
+
### Sequential by Default
|
|
44
|
+
|
|
45
|
+
Steps execute in order. Each step waits for previous step completion.
|
|
46
|
+
|
|
47
|
+
```
|
|
48
|
+
Step 1 → complete → Step 2 → complete → Step 3
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
### Output Passing
|
|
52
|
+
|
|
53
|
+
Output from step N is available to step N+1 and beyond.
|
|
54
|
+
|
|
55
|
+
```yaml
|
|
56
|
+
steps:
|
|
57
|
+
- id: analyze
|
|
58
|
+
output: analysis # Creates ${analysis}
|
|
59
|
+
|
|
60
|
+
- id: review
|
|
61
|
+
input: { data: "${analysis}" } # Uses ${analysis}
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
### Error Handling
|
|
65
|
+
|
|
66
|
+
```yaml
|
|
67
|
+
error_handling:
|
|
68
|
+
default: stop # stop | continue | retry
|
|
69
|
+
|
|
70
|
+
steps:
|
|
71
|
+
- id: risky_step
|
|
72
|
+
on_error: continue # Override for this step
|
|
73
|
+
retry:
|
|
74
|
+
max_attempts: 3
|
|
75
|
+
delay: 1000
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
## Pipeline Commands
|
|
79
|
+
|
|
80
|
+
| Command | Description |
|
|
81
|
+
|---------|-------------|
|
|
82
|
+
| `pipeline:run <name>` | Execute a pipeline |
|
|
83
|
+
| `pipeline:list` | List available pipelines |
|
|
84
|
+
| `pipeline:status` | Show running pipeline status |
|
|
85
|
+
|
|
86
|
+
## Pipeline Locations
|
|
87
|
+
|
|
88
|
+
```
|
|
89
|
+
pipelines/
|
|
90
|
+
├── index.yaml # Pipeline registry
|
|
91
|
+
├── templates/ # Pipeline templates
|
|
92
|
+
│ └── pipeline-template.yaml
|
|
93
|
+
└── examples/ # Example pipelines
|
|
94
|
+
└── code-review.yaml
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
## Example Pipeline
|
|
98
|
+
|
|
99
|
+
### code-review.yaml
|
|
100
|
+
|
|
101
|
+
```yaml
|
|
102
|
+
name: code-review
|
|
103
|
+
description: Full code review workflow
|
|
104
|
+
|
|
105
|
+
inputs:
|
|
106
|
+
- name: file_path
|
|
107
|
+
required: true
|
|
108
|
+
|
|
109
|
+
steps:
|
|
110
|
+
- id: detect_language
|
|
111
|
+
agent: secretary
|
|
112
|
+
action: detect_language
|
|
113
|
+
input: { file: "${file_path}" }
|
|
114
|
+
output: language
|
|
115
|
+
|
|
116
|
+
- id: analyze
|
|
117
|
+
agent: "${language}-expert"
|
|
118
|
+
action: analyze
|
|
119
|
+
input: { file: "${file_path}" }
|
|
120
|
+
output: analysis
|
|
121
|
+
|
|
122
|
+
- id: security_check
|
|
123
|
+
agent: qa-lead
|
|
124
|
+
action: security_review
|
|
125
|
+
input: { findings: "${analysis}" }
|
|
126
|
+
output: security
|
|
127
|
+
|
|
128
|
+
- id: report
|
|
129
|
+
agent: documenter
|
|
130
|
+
action: summarize
|
|
131
|
+
input:
|
|
132
|
+
analysis: "${analysis}"
|
|
133
|
+
security: "${security}"
|
|
134
|
+
output: report
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
## Execution Output
|
|
138
|
+
|
|
139
|
+
```
|
|
140
|
+
[Pipeline] code-review
|
|
141
|
+
├── [1/4] detect_language: ✓ Go detected
|
|
142
|
+
├── [2/4] analyze: ✓ 5 issues found
|
|
143
|
+
├── [3/4] security_check: ✓ No vulnerabilities
|
|
144
|
+
└── [4/4] report: ✓ Summary generated
|
|
145
|
+
|
|
146
|
+
[Complete] Pipeline finished successfully
|
|
147
|
+
Output: ${report}
|
|
148
|
+
```
|
|
149
|
+
|
|
150
|
+
## Secretary Integration
|
|
151
|
+
|
|
152
|
+
Secretary can:
|
|
153
|
+
1. Load and validate pipeline definitions
|
|
154
|
+
2. Execute pipelines step-by-step
|
|
155
|
+
3. Pass variables between steps
|
|
156
|
+
4. Report progress and results
|
|
157
|
+
5. Handle errors according to policy
|
|
158
|
+
|
|
159
|
+
## Benefits
|
|
160
|
+
|
|
161
|
+
1. **Reproducibility**: Same workflow, consistent results
|
|
162
|
+
2. **Composability**: Build complex workflows from simple steps
|
|
163
|
+
3. **Visibility**: Clear step-by-step progress
|
|
164
|
+
4. **Error Recovery**: Defined error handling per step
|
|
165
|
+
5. **Reusability**: Save and reuse common workflows
|
|
@@ -0,0 +1,125 @@
|
|
|
1
|
+
# Baekgom Agents - Global Rules
|
|
2
|
+
# Priority: MUST > SHOULD > MAY
|
|
3
|
+
|
|
4
|
+
rules:
|
|
5
|
+
# MUST - Never violate
|
|
6
|
+
- id: R000
|
|
7
|
+
name: language-policy
|
|
8
|
+
title: Language & Delegation Policy
|
|
9
|
+
path: ./MUST-language-policy.md
|
|
10
|
+
priority: MUST
|
|
11
|
+
scope: all
|
|
12
|
+
|
|
13
|
+
- id: R001
|
|
14
|
+
name: safety
|
|
15
|
+
title: Safety Rules
|
|
16
|
+
path: ./MUST-safety.md
|
|
17
|
+
priority: MUST
|
|
18
|
+
scope: all
|
|
19
|
+
|
|
20
|
+
- id: R002
|
|
21
|
+
name: permissions
|
|
22
|
+
title: Permission Rules
|
|
23
|
+
path: ./MUST-permissions.md
|
|
24
|
+
priority: MUST
|
|
25
|
+
scope: all
|
|
26
|
+
|
|
27
|
+
# SHOULD - Strongly recommended
|
|
28
|
+
- id: R003
|
|
29
|
+
name: interaction
|
|
30
|
+
title: Interaction Rules
|
|
31
|
+
path: ./SHOULD-interaction.md
|
|
32
|
+
priority: SHOULD
|
|
33
|
+
scope: all
|
|
34
|
+
|
|
35
|
+
- id: R004
|
|
36
|
+
name: error-handling
|
|
37
|
+
title: Error Handling Rules
|
|
38
|
+
path: ./SHOULD-error-handling.md
|
|
39
|
+
priority: SHOULD
|
|
40
|
+
scope: all
|
|
41
|
+
|
|
42
|
+
- id: R007
|
|
43
|
+
name: agent-identification
|
|
44
|
+
title: Agent Identification Rules
|
|
45
|
+
path: ./SHOULD-agent-identification.md
|
|
46
|
+
priority: SHOULD
|
|
47
|
+
scope: all
|
|
48
|
+
|
|
49
|
+
- id: R008
|
|
50
|
+
name: tool-identification
|
|
51
|
+
title: Tool Usage Identification Rules
|
|
52
|
+
path: ./SHOULD-tool-identification.md
|
|
53
|
+
priority: SHOULD
|
|
54
|
+
scope: all
|
|
55
|
+
|
|
56
|
+
# MAY - Optional
|
|
57
|
+
- id: R005
|
|
58
|
+
name: optimization
|
|
59
|
+
title: Optimization Guide
|
|
60
|
+
path: ./MAY-optimization.md
|
|
61
|
+
priority: MAY
|
|
62
|
+
scope: all
|
|
63
|
+
|
|
64
|
+
- id: R009
|
|
65
|
+
name: parallel-execution
|
|
66
|
+
title: Parallel Execution Rules
|
|
67
|
+
path: ./MAY-parallel-execution.md
|
|
68
|
+
priority: MAY
|
|
69
|
+
scope: agents
|
|
70
|
+
|
|
71
|
+
# Agent Design - MUST
|
|
72
|
+
- id: R006
|
|
73
|
+
name: agent-design
|
|
74
|
+
title: Agent Design Rules
|
|
75
|
+
path: ./MUST-agent-design.md
|
|
76
|
+
priority: MUST
|
|
77
|
+
scope: agents
|
|
78
|
+
|
|
79
|
+
# Orchestrator Coordination - MUST
|
|
80
|
+
- id: R010
|
|
81
|
+
name: orchestrator-coordination
|
|
82
|
+
title: Orchestrator Coordination Rules
|
|
83
|
+
path: ./MUST-orchestrator-coordination.md
|
|
84
|
+
priority: MUST
|
|
85
|
+
scope: agents
|
|
86
|
+
|
|
87
|
+
# Memory Integration - SHOULD
|
|
88
|
+
- id: R011
|
|
89
|
+
name: memory-integration
|
|
90
|
+
title: Memory Integration Rules
|
|
91
|
+
path: ./SHOULD-memory-integration.md
|
|
92
|
+
priority: SHOULD
|
|
93
|
+
scope: all
|
|
94
|
+
|
|
95
|
+
# HUD Statusline - SHOULD
|
|
96
|
+
- id: R012
|
|
97
|
+
name: hud-statusline
|
|
98
|
+
title: HUD Statusline Rules
|
|
99
|
+
path: ./SHOULD-hud-statusline.md
|
|
100
|
+
priority: SHOULD
|
|
101
|
+
scope: all
|
|
102
|
+
|
|
103
|
+
# Ecomode - SHOULD
|
|
104
|
+
- id: R013
|
|
105
|
+
name: ecomode
|
|
106
|
+
title: Ecomode Rules
|
|
107
|
+
path: ./SHOULD-ecomode.md
|
|
108
|
+
priority: SHOULD
|
|
109
|
+
scope: all
|
|
110
|
+
|
|
111
|
+
# Pipeline Mode - SHOULD
|
|
112
|
+
- id: R014
|
|
113
|
+
name: pipeline-mode
|
|
114
|
+
title: Pipeline Mode Rules
|
|
115
|
+
path: ./SHOULD-pipeline-mode.md
|
|
116
|
+
priority: SHOULD
|
|
117
|
+
scope: orchestrator
|
|
118
|
+
|
|
119
|
+
# Intent Transparency - MUST
|
|
120
|
+
- id: R015
|
|
121
|
+
name: intent-transparency
|
|
122
|
+
title: Intent Transparency Rules
|
|
123
|
+
path: ./MUST-intent-transparency.md
|
|
124
|
+
priority: MUST
|
|
125
|
+
scope: orchestrator
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
#!/bin/bash
|
|
2
|
+
# Claude Code Hooks & Contexts Uninstaller
|
|
3
|
+
# Removes hooks installed by install-hooks.sh
|
|
4
|
+
|
|
5
|
+
set -e
|
|
6
|
+
|
|
7
|
+
CLAUDE_HOME="${HOME}/.claude"
|
|
8
|
+
SETTINGS_FILE="${CLAUDE_HOME}/settings.json"
|
|
9
|
+
|
|
10
|
+
echo "┌─────────────────────────────────────────────┐"
|
|
11
|
+
echo "│ Claude Code Hooks Uninstaller │"
|
|
12
|
+
echo "└─────────────────────────────────────────────┘"
|
|
13
|
+
echo ""
|
|
14
|
+
|
|
15
|
+
read -p "This will remove hooks from ~/.claude/. Continue? [y/N] " -n 1 -r
|
|
16
|
+
echo ""
|
|
17
|
+
|
|
18
|
+
if [[ ! $REPLY =~ ^[Yy]$ ]]; then
|
|
19
|
+
echo "Cancelled."
|
|
20
|
+
exit 0
|
|
21
|
+
fi
|
|
22
|
+
|
|
23
|
+
echo ""
|
|
24
|
+
echo "[1/3] Removing hook scripts..."
|
|
25
|
+
rm -rf "${CLAUDE_HOME}/hooks/memory-persistence"
|
|
26
|
+
rm -rf "${CLAUDE_HOME}/hooks/strategic-compact"
|
|
27
|
+
echo " ✓ Hook scripts removed"
|
|
28
|
+
|
|
29
|
+
echo "[2/3] Removing context files..."
|
|
30
|
+
rm -f "${CLAUDE_HOME}/contexts/dev.md"
|
|
31
|
+
rm -f "${CLAUDE_HOME}/contexts/review.md"
|
|
32
|
+
rm -f "${CLAUDE_HOME}/contexts/research.md"
|
|
33
|
+
echo " ✓ Context files removed"
|
|
34
|
+
|
|
35
|
+
echo "[3/3] Cleaning settings.json..."
|
|
36
|
+
if [ -f "$SETTINGS_FILE" ] && command -v jq &> /dev/null; then
|
|
37
|
+
TEMP_FILE=$(mktemp)
|
|
38
|
+
jq 'del(.hooks)' "$SETTINGS_FILE" > "$TEMP_FILE"
|
|
39
|
+
mv "$TEMP_FILE" "$SETTINGS_FILE"
|
|
40
|
+
echo " ✓ Hooks removed from settings.json"
|
|
41
|
+
else
|
|
42
|
+
echo " ⚠ Please manually remove 'hooks' from settings.json"
|
|
43
|
+
fi
|
|
44
|
+
|
|
45
|
+
echo ""
|
|
46
|
+
echo "┌─────────────────────────────────────────────┐"
|
|
47
|
+
echo "│ Uninstall Complete! │"
|
|
48
|
+
echo "└─────────────────────────────────────────────┘"
|
|
49
|
+
echo ""
|
|
50
|
+
echo "Note: sessions/ and skills/ directories preserved."
|
|
51
|
+
echo "Remove manually if needed: rm -rf ~/.claude/sessions ~/.claude/skills"
|
|
52
|
+
echo ""
|