safeword 0.7.4 → 0.7.6

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.
Files changed (3) hide show
  1. package/package.json +14 -15
  2. package/templates/SAFEWORD.md +36 -27
  3. package/templates/scripts/lint-md.sh +0 -0
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "safeword",
3
- "version": "0.7.4",
3
+ "version": "0.7.6",
4
4
  "description": "CLI for setting up and managing safeword development environments",
5
5
  "type": "module",
6
6
  "bin": {
@@ -19,18 +19,6 @@
19
19
  "engines": {
20
20
  "node": ">=18"
21
21
  },
22
- "scripts": {
23
- "build": "tsup",
24
- "dev": "tsup --watch",
25
- "test": "vitest run",
26
- "test:e2e": "vitest run tests/e2e/",
27
- "test:watch": "vitest",
28
- "test:coverage": "vitest run --coverage",
29
- "typecheck": "tsc --noEmit",
30
- "lint": "eslint src tests",
31
- "clean": "rm -rf dist",
32
- "prepublishOnly": "npm run build && npm test"
33
- },
34
22
  "dependencies": {
35
23
  "commander": "^12.1.0"
36
24
  },
@@ -48,5 +36,16 @@
48
36
  "claude-code"
49
37
  ],
50
38
  "author": "",
51
- "license": "MIT"
52
- }
39
+ "license": "MIT",
40
+ "scripts": {
41
+ "build": "tsup",
42
+ "dev": "tsup --watch",
43
+ "test": "vitest run",
44
+ "test:e2e": "vitest run tests/e2e/",
45
+ "test:watch": "vitest",
46
+ "test:coverage": "vitest run --coverage",
47
+ "typecheck": "tsc --noEmit",
48
+ "lint": "eslint src tests",
49
+ "clean": "rm -rf dist"
50
+ }
51
+ }
package/templates/SAFEWORD.md CHANGED
@@ -44,21 +44,21 @@ Training data is stale. Follow this sequence:
44
44
 
45
45
  **Read the matching guide when ANY trigger fires:**
46
46
 
47
- | Trigger | Guide |
48
- | --------------------------------------------------------- | ---------------------------------------------- |
49
- | Starting ANY feature, bug fix, or enhancement | @./.safeword/guides/development-workflow.md |
50
- | Need to write OR review user stories | @./.safeword/guides/user-story-guide.md |
51
- | Need to write OR review test definitions | @./.safeword/guides/test-definitions-guide.md |
52
- | Writing tests, doing TDD, or test is failing | @./.safeword/guides/tdd-best-practices.md |
53
- | Creating OR updating a design doc | @./.safeword/guides/design-doc-guide.md |
54
- | Making architectural decision OR writing ADR | @./.safeword/guides/architecture-guide.md |
55
- | Designing data models, schemas, or database changes | @./.safeword/guides/data-architecture-guide.md |
56
- | Calling LLM APIs OR writing LLM-consumable docs | @./.safeword/guides/llm-guide.md |
57
- | Updating CLAUDE.md, SAFEWORD.md, or any context file | @./.safeword/guides/context-files-guide.md |
58
- | Hit same bug 3+ times OR discovered undocumented gotcha | @./.safeword/guides/learning-extraction.md |
59
- | Process hanging, port in use, or zombie process suspected | @./.safeword/guides/zombie-process-cleanup.md |
60
- | Using `safeword` CLI commands | @./.safeword/guides/cli-reference.md |
61
- | Debugging issues OR need git/cross-platform guidance | @./.safeword/guides/code-philosophy.md |
47
+ | Trigger | Guide |
48
+ | --------------------------------------------------------- | ----------------------------------------------- |
49
+ | Starting ANY feature, bug fix, or enhancement | `./.safeword/guides/development-workflow.md` |
50
+ | Need to write OR review user stories | `./.safeword/guides/user-story-guide.md` |
51
+ | Need to write OR review test definitions | `./.safeword/guides/test-definitions-guide.md` |
52
+ | Writing tests, doing TDD, or test is failing | `./.safeword/guides/tdd-best-practices.md` |
53
+ | Creating OR updating a design doc | `./.safeword/guides/design-doc-guide.md` |
54
+ | Making architectural decision OR writing ADR | `./.safeword/guides/architecture-guide.md` |
55
+ | Designing data models, schemas, or database changes | `./.safeword/guides/data-architecture-guide.md` |
56
+ | Calling LLM APIs OR writing LLM-consumable docs | `./.safeword/guides/llm-guide.md` |
57
+ | Updating CLAUDE.md, SAFEWORD.md, or any context file | `./.safeword/guides/context-files-guide.md` |
58
+ | Hit same bug 3+ times OR discovered undocumented gotcha | `./.safeword/guides/learning-extraction.md` |
59
+ | Process hanging, port in use, or zombie process suspected | `./.safeword/guides/zombie-process-cleanup.md` |
60
+ | Using `safeword` CLI commands | `./.safeword/guides/cli-reference.md` |
61
+ | Debugging issues OR need git/cross-platform guidance | `./.safeword/guides/code-philosophy.md` |
62
62
 
63
63
  ---
64
64
 
@@ -66,15 +66,15 @@ Training data is stale. Follow this sequence:
66
66
 
67
67
  **Use the matching template when ANY trigger fires:**
68
68
 
69
- | Trigger | Template |
70
- | ---------------------------------------------------------- | -------------------------------------------------- |
71
- | Planning new feature scope OR creating feature spec | @./.safeword/templates/feature-spec-template.md |
72
- | Bug, improvement, refactor, or internal task | @./.safeword/templates/task-spec-template.md |
73
- | Need test definitions for a feature OR acceptance criteria | @./.safeword/templates/test-definitions-feature.md |
74
- | Feature spans 3+ components OR needs technical spec | @./.safeword/templates/design-doc-template.md |
75
- | Making decision with long-term impact OR trade-offs | @./.safeword/templates/architecture-template.md |
76
- | Task needs context anchoring (see Ticket System below) | @./.safeword/templates/ticket-template.md |
77
- | Starting execution of a plan, ticket, or spec | @./.safeword/templates/work-log-template.md |
69
+ | Trigger | Template |
70
+ | ---------------------------------------------------------- | --------------------------------------------------- |
71
+ | Planning new feature scope OR creating feature spec | `./.safeword/templates/feature-spec-template.md` |
72
+ | Bug, improvement, refactor, or internal task | `./.safeword/templates/task-spec-template.md` |
73
+ | Need test definitions for a feature OR acceptance criteria | `./.safeword/templates/test-definitions-feature.md` |
74
+ | Feature spans 3+ components OR needs technical spec | `./.safeword/templates/design-doc-template.md` |
75
+ | Making decision with long-term impact OR trade-offs | `./.safeword/templates/architecture-template.md` |
76
+ | Task needs context anchoring (see Ticket System below) | `./.safeword/templates/ticket-template.md` |
77
+ | Starting execution of a plan, ticket, or spec | `./.safeword/templates/work-log-template.md` |
78
78
 
79
79
  ---
80
80
 
@@ -182,7 +182,6 @@ status: in_progress
182
182
  | ------------------------------- | ---------------------------------------------------------------------------- |
183
183
  | Multiple artifacts at once | One log per artifact (don't combine) |
184
184
  | No clear artifact (exploratory) | Create `explore-{topic}.md`, convert to proper artifact when scope clarifies |
185
- | Resuming after context loss | Re-read entire log before continuing |
186
185
 
187
186
  ---
188
187
 
@@ -287,9 +286,19 @@ When markdown lint reports MD040 (missing language), choose:
287
286
 
288
287
  ---
289
288
 
290
- ## Learning Extraction
289
+ ## Learnings
291
290
 
292
- **Suggest extraction when ANY apply:**
291
+ **Location:** `.safeword/learnings/`
292
+
293
+ **Check learnings FIRST when:**
294
+
295
+ 1. Stuck on an issue OR debugging same problem 2+ times
296
+ 2. Working with unfamiliar technology in this codebase
297
+ 3. Issue involves testing, processes, or integrations
298
+
299
+ **How:** `ls .safeword/learnings/` then read relevant files.
300
+
301
+ **Extract new learning when ANY apply:**
293
302
 
294
303
  - 5+ debug cycles on same issue
295
304
  - 3+ approaches tried
package/templates/scripts/lint-md.sh CHANGED
File without changes