oh-my-customcode 0.179.0 → 0.180.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/dist/cli/index.js +1 -1
- package/dist/index.js +1 -1
- package/package.json +1 -1
- package/templates/.claude/rules/MUST-completion-verification.md +28 -0
- package/templates/.claude/rules/MUST-parallel-execution.md +12 -0
- package/templates/.claude/rules/MUST-safety.md +24 -0
- package/templates/.claude/rules/SHOULD-memory-integration.md +12 -0
- package/templates/.claude/skills/homework/SKILL.md +11 -0
- package/templates/manifest.json +1 -1
package/dist/cli/index.js
CHANGED
package/dist/index.js
CHANGED
package/package.json
CHANGED
|
@@ -200,6 +200,19 @@ triage-dispatch.yml 실패 원인을 파일 Read 전에 "triaged 라벨 부재 +
|
|
|
200
200
|
|
|
201
201
|
Origin: #1266 ④.
|
|
202
202
|
|
|
203
|
+
### Proxy Signal vs Canonical Ground-Truth (#1336 ①②)
|
|
204
|
+
|
|
205
|
+
> Origin: #1336 ①② — transcription was alarmed as "stopped" because `.txt` files looked stale, but the canonical DB had transcripts current to 06-09 21:30 (.txt is not the whisper collector's output — it emits only to the DB). Separately, SMS was over-diagnosed as "fully blocked" from one empty OneDrive XML path + a single 401, while the DB held 17 SMS rows ingested via the app path.
|
|
206
|
+
|
|
207
|
+
When diagnosing pipeline/data state, verify the CANONICAL store (the authoritative datastore — DB, the system of record) BEFORE characterizing state from a secondary proxy (a `.txt`/file artifact) or a single ingestion path. Two failure modes share this meta-pattern:
|
|
208
|
+
|
|
209
|
+
| Anti-pattern | Required |
|
|
210
|
+
|--------------|----------|
|
|
211
|
+
| Characterize pipeline health from a filesystem proxy (`.txt` presence/mtime) | Query the canonical store (DB transcript count/recency) first |
|
|
212
|
+
| Generalize one ingestion path's failure (one empty XML / one 401) to "whole pipeline blocked" | Check the final landing store's count across ALL paths before concluding blockage |
|
|
213
|
+
|
|
214
|
+
A single path's failure does NOT prove the whole multi-path pipeline is down. Confirm the system-of-record before alarming or dispatching reprocessing.
|
|
215
|
+
|
|
203
216
|
### Directory-Context Before Multi-Copy Unification/Deletion
|
|
204
217
|
|
|
205
218
|
다중 사본(동일 파일이 N곳에 존재)을 통일하거나 삭제하기 전, 각 사본이 위치한 **디렉토리 전체 맥락**을 확인한다(`ls`로 형제 파일 파악). 사본 파일 하나만 보고 "orphan"·"stub"으로 특성화하면, 같은 디렉토리의 형제 파일(다른 역할을 가진)이 함께 덮이거나 맥락이 누락된다. Read-Before-Characterize를 파일 단위에서 디렉토리 단위로 확장한 규칙이다.
|
|
@@ -256,6 +269,21 @@ A CI publish/deploy step that LOGS an error has NOT necessarily failed — the s
|
|
|
256
269
|
|
|
257
270
|
This is the publish-domain extension of Read-Before-Characterize ("actual outcome ≠ attempt"). Re-running a publish that actually succeeded risks duplicate-publish errors; permanently changing a workflow on a misdiagnosis is worse (cf. #1217 — npm E403 misdiagnosed as a `--provenance` conflict → wrong workflow change → repeated failure; real cause was token scope).
|
|
258
271
|
|
|
272
|
+
### State-Change Claim → Live System Verification (#1335 ①)
|
|
273
|
+
|
|
274
|
+
> Origin: #1335 ① — issue #101 (secretary teardown) was closed as "대체 완료·teardown 보류", but the secretary LaunchAgents (onedrive-bridge / calendar-worker / minikube-mount) were STILL running on the host. The user caught it ("secretary 리소스 다 내려가있는거 맞지?") — they were not.
|
|
275
|
+
|
|
276
|
+
Before closing or marking-done an issue/task that CLAIMS an infrastructure or resource STATE change (a service stopped, a resource torn down, a deployment removed, a process killed), verify the ACTUAL live system state — not just that the change command was issued. "Issued the teardown" ≠ "the resource is down".
|
|
277
|
+
|
|
278
|
+
| Claimed state change | Live ground-truth check |
|
|
279
|
+
|----------------------|-------------------------|
|
|
280
|
+
| LaunchAgent/service stopped | `launchctl list` / `systemctl status` shows it absent/inactive |
|
|
281
|
+
| k8s resource torn down | `kubectl get <resource>` returns NotFound |
|
|
282
|
+
| Container removed | `docker ps -a` does not list it |
|
|
283
|
+
| Process killed | process check (`pgrep`/`ps`) returns empty |
|
|
284
|
+
|
|
285
|
+
This is the infra/state extension of "actual outcome ≠ attempt". Closing on the command-issued assumption leaves orphaned running resources.
|
|
286
|
+
|
|
259
287
|
## Integration
|
|
260
288
|
|
|
261
289
|
| Rule | Interaction |
|
|
@@ -192,3 +192,15 @@ The list form mirrors the tool-call `[N]` prefix pattern and scales better to 3+
|
|
|
192
192
|
✓ agent-1: success
|
|
193
193
|
✗ agent-2: failed (reason)
|
|
194
194
|
```
|
|
195
|
+
|
|
196
|
+
## Parallel Feature Integration Gate
|
|
197
|
+
|
|
198
|
+
> Origin: #1335 ③ — parallel lang-kotlin-expert rounds each reported "build green", but the COMBINED runtime had a DataStore singleton crash, a Settings→Dashboard nav crash, a recording 400, and cursor pre-advance bugs — caught only by on-device testing.
|
|
199
|
+
|
|
200
|
+
Per-subagent "build green" does NOT guarantee integrated runtime correctness. When parallel feature subagents edit interdependent code, the orchestrator MUST run an INTEGRATION verification gate after the parallel work merges — a combined build PLUS a runtime/smoke check (or device test for apps) — before declaring the feature done. Independent green builds can still combine into runtime crashes (shared singletons, navigation, API contracts).
|
|
201
|
+
|
|
202
|
+
| Anti-pattern | Required |
|
|
203
|
+
|--------------|----------|
|
|
204
|
+
| Trust each parallel subagent's "build green" and declare done | Orchestrator runs a combined build + runtime/smoke gate on the merged result first |
|
|
205
|
+
|
|
206
|
+
Cross-reference: R020 (actual outcome ≠ attempt; completion verification).
|
|
@@ -70,6 +70,30 @@ Prefer a reversible action (disable/detach/stop) over delete when the goal can b
|
|
|
70
70
|
|
|
71
71
|
> **Ask-before-scan (#1327 찐빠 #4)**: When a credential/token is needed, request it from the user BEFORE running BLIND/DISCOVERY credential scans (`env | grep`, repo-wide token greps), which trip the Credential Exploration classifier. Reading a SPECIFIC file the user named to obtain a value is not a discovery scan and is fine. If a scan trips the classifier, do not retry it (R010 Subagent Scope-Creep STOP Protocol).
|
|
72
72
|
|
|
73
|
+
### Infra-Diagnostic File Checks — Metadata, Not Contents (#1334 ①)
|
|
74
|
+
|
|
75
|
+
> Origin: #1334 ① — during a hermes 502 diagnosis, a `cat .env` + `credentials.json` key inspect was reflexively bundled into a diagnostic batch and tripped the Credential Exploration classifier. The secret values were never needed for the 502 diagnosis.
|
|
76
|
+
|
|
77
|
+
When diagnosing infrastructure/health issues (502s, container state, env presence), file checks MUST use metadata-only commands — `ls -la` (existence, size, perms, mtime) — NEVER `cat .env`, `cat credentials.json`, or any command that reads secret CONTENTS or keys into the transcript. Confirming a file EXISTS is a metadata check; reading its values is a credential scan.
|
|
78
|
+
|
|
79
|
+
| Anti-pattern | Required |
|
|
80
|
+
|--------------|----------|
|
|
81
|
+
| `cat .env` / inspect OAuth/credential keys to "confirm config present" during a health diagnosis | `ls -la .env` — existence/size/perms only; request a specific value from the user if genuinely needed |
|
|
82
|
+
|
|
83
|
+
Cross-reference: the Ask-before-scan note above (discovery scans), R010 Subagent Scope-Creep STOP.
|
|
84
|
+
|
|
85
|
+
### Standing User-Deny + Classifier Block → Immediate user-runs Switch (#1335 ④)
|
|
86
|
+
|
|
87
|
+
> Origin: #1335 ④ — with a standing user constraint "절대 시크릿 건드리지 마" plus a classifier block, an `.env.local` edit (DATABASE_URL, LLM_MAX_TOKENS) was retried and blocked repeatedly instead of handing the edit to the user.
|
|
88
|
+
|
|
89
|
+
When the user has a STANDING "don't touch X" constraint AND the safety classifier blocks an action on X even once, immediately switch to the `!` user-runs pattern — surface the exact command for the user to run themselves — and do NOT retry the blocked edit. A standing deny + one classifier trip is a hard signal to delegate to the user, not to find another path in.
|
|
90
|
+
|
|
91
|
+
| Anti-pattern | Required |
|
|
92
|
+
|--------------|----------|
|
|
93
|
+
| Retry a blocked edit on a user-deny-listed path via a different mechanism | Stop after the first block; emit the command for the user to run via `!` and wait |
|
|
94
|
+
|
|
95
|
+
Cross-reference: R010 Subagent Scope-Creep STOP Protocol (2-trip stop), R015 Failed Tool Re-Try Discipline.
|
|
96
|
+
|
|
73
97
|
Cross-reference: R010 Subagent Scope-Creep STOP Protocol, R002 (permission tiers).
|
|
74
98
|
|
|
75
99
|
## Required Before Destructive Operations
|
|
@@ -21,6 +21,18 @@ Agent frontmatter `memory: project|user|local` enables persistent memory:
|
|
|
21
21
|
| `project` | `.claude/agent-memory/<name>/` | Yes |
|
|
22
22
|
| `local` | `.claude/agent-memory-local/<name>/` | No |
|
|
23
23
|
|
|
24
|
+
## Subagent memory:project Source-Tree Pollution Guard
|
|
25
|
+
|
|
26
|
+
> Origin: #1335 ② — lang-kotlin-expert with `memory: project`, working in a Kotlin source subdirectory, wrote memory to `mobile/.../com/baekenough/secondbrain/.claude/agent-memory/` — INSIDE the source package. Caught and removed just before commit.
|
|
27
|
+
|
|
28
|
+
A subagent with `memory: project` working in a SUBDIRECTORY can create `.claude/agent-memory/` relative to its current working directory, polluting the source tree (e.g., inside a source package). Memory MUST resolve to the PROJECT ROOT `.claude/`, never a nested working dir.
|
|
29
|
+
|
|
30
|
+
| Anti-pattern | Required |
|
|
31
|
+
|--------------|----------|
|
|
32
|
+
| Accept a subagent's `.claude/agent-memory/` written under a source package | Verify memory writes land at project-root `.claude/`; remove any nested `.claude/agent-memory/` from source dirs before commit |
|
|
33
|
+
|
|
34
|
+
Check for nested `.claude/agent-memory/` (e.g., `find . -path '*/src/*/.claude' -o -path '*/main/*/.claude'`) before committing subagent work.
|
|
35
|
+
|
|
24
36
|
## Best Practices
|
|
25
37
|
|
|
26
38
|
- Consult memory before starting work
|
|
@@ -168,6 +168,17 @@ If `--dry-run` is active, skip this phase and output the draft directly to the c
|
|
|
168
168
|
└── 다음 액션: {harness 제안 있으면 표시, 없으면 "없음"}
|
|
169
169
|
```
|
|
170
170
|
|
|
171
|
+
## Cross-Project Import Compatibility
|
|
172
|
+
|
|
173
|
+
When `homework` is imported into a project OTHER than oh-my-customcode, its automatic `omcustom-feedback` invocation (the retrospective-filing phase) depends on `omcustom-feedback` being model-invocable in that project.
|
|
174
|
+
|
|
175
|
+
| Condition | Behavior |
|
|
176
|
+
|-----------|----------|
|
|
177
|
+
| `omcustom-feedback` model-invocable (default in oh-my-customcode) | Auto-invoke files the retrospective normally |
|
|
178
|
+
| `omcustom-feedback` has model invocation DISABLED (`disable-model-invocation`) in the importing project | Auto-invoke FAILS — fall back to MANUAL submission: present the drafted findings to the user and ask them to file the feedback (or run `omcustom-feedback` manually) |
|
|
179
|
+
|
|
180
|
+
> Origin: #1336 — in the second-brain project, `omcustom-feedback` was model-invocation-disabled, so homework Phase 5's automatic invoke failed; the retrospective was filed manually. Document this dependency so cross-project imports degrade gracefully instead of silently failing the auto-file step.
|
|
181
|
+
|
|
171
182
|
## Options Reference
|
|
172
183
|
|
|
173
184
|
| Option | Default | Description |
|
package/templates/manifest.json
CHANGED