@codebehind/agent-workflow 1.1.15 → 1.1.16

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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@codebehind/agent-workflow",
3
- "version": "1.1.15",
3
+ "version": "1.1.16",
4
4
  "description": "Scaffold the agent-workflow spec-driven delivery framework into any repo",
5
5
  "type": "module",
6
6
  "bin": {
@@ -94,8 +94,8 @@ When writing final documentation, choose update/create in this order:
94
94
  To reduce onboarding cost, use a reusable codebase snapshot file:
95
95
 
96
96
  - Path: `.agent-workflow/codebase.md`
97
- - If the file is missing, the first onboarded agent scans the codebase and creates it.
98
- - If the file exists, agents read it instead of rescanning the codebase.
97
+ - **If the file is missing, create it immediately before doing any other work.** Scan the codebase and write the snapshot. Do not ask, do not wait.
98
+ - If the file exists, read it instead of rescanning the codebase.
99
99
  - Rescan and refresh this file only when the user explicitly asks.
100
100
 
101
101
  Expected snapshot structure (keep concise and high-level):
@@ -6,7 +6,7 @@ Follow these rules in every session.
6
6
  ## Read order at session start
7
7
  1. Read `AGENTS.md` — determines repo mode (single-repo vs meta-repo) and project context
8
8
  2. Read `.agent-workflow/README.md`
9
- 3. Read `.agent-workflow/codebase.md` if it exists
9
+ 3. Read `.agent-workflow/codebase.md` — **if it does not exist, create it immediately by scanning the codebase before continuing**
10
10
  4. Read the target spec and any linked feature doc before planning or implementation
11
11
  5. Read relevant existing code (in the appropriate directory) before proposing structural changes
12
12
 
@@ -11,7 +11,7 @@ See `agents-workflow-dev-process.md` for both the **scripted workflow** (bash sc
11
11
  ## Quick Start
12
12
 
13
13
  1. Read `.agent-workflow/README.md` (workflow process — **Phase A** spec authorship vs **Phase B** delivery).
14
- 2. Read `.agent-workflow/codebase.md` (codebase snapshot — do NOT rescan unless explicitly asked).
14
+ 2. Read `.agent-workflow/codebase.md` (codebase snapshot). **If it does not exist, create it immediately by scanning the codebase — do not skip this step.** Do NOT rescan if it already exists unless explicitly asked.
15
15
  3. Determine the task:
16
16
  - **Prepare a spec** (user pasted Notion URL, asked for chat-assisted drafting, or asked to convert Notion → spec): follow **Phase A**; write `.agent-workflow/specs/*.md` with `status: draft` unless the user says otherwise; use `.agent-workflow/notion-spec-mapping.md` for Notion.
17
17
  - **Implement a feature**: only specs with **`status: open`**; check `.agent-workflow/specs/` for those.