Skip to content

Commit 7be38e0

Browse files
clark-mackeyclark-mackey
committed
chore: dogfood update - sync local LFG install to latest product version
AI rules updated from 115 to 213 lines: adds session handoff, token self-assessment, entry verbosity (compact/incident/standard), cross-references, archival summaries. Fixed stale related_docs paths in .logfile-config.yml.
1 parent 8f20e71 commit 7be38e0

File tree

3 files changed

+105
-7
lines changed

3 files changed

+105
-7
lines changed

‎.augment/rules/log-file-maintenance.md‎

Lines changed: 101 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -78,8 +78,104 @@ This rule is ALWAYS active. Violations require immediate self-correction.
7878
## 🔄 SESSION START
7979

8080
**At start of EVERY session:**
81-
1. Read `logs/DEVLOG.md` → "Current Context" section
82-
2. Acknowledge: "Context read. Version [x], Phase [y], Objectives: [z]"
81+
1. Read `logs/DEVLOG.md` → "Last Session" section (if exists) for handoff context
82+
2. Read `logs/DEVLOG.md` → "Current Context" section
83+
3. **Staleness check:** If `Last Updated` date is >7 days old, update Current Context BEFORE other work
84+
- Tell user: "Current Context is X days old. Updating before proceeding."
85+
- Update: version, phase, objectives, recent changes
86+
- Set new `Last Updated` date
87+
4. Acknowledge: "Context read. Version [x], Phase [y], Objectives: [z]"
88+
89+
---
90+
91+
## 🔚 SESSION END
92+
93+
**⚠️ Multi-agent:** If you are a subagent or teammate (not the lead/primary agent), skip this section. Only the primary agent writes session handoffs.
94+
95+
**Before ending a session, write a handoff note:**
96+
97+
1. Update `logs/DEVLOG.md` → "Last Session" section (overwrite previous)
98+
2. Format (3 bullets max, <150 tokens):
99+
```
100+
## Last Session
101+
- **Done:** [What was completed this session]
102+
- **In Progress:** [What's partially done, current state]
103+
- **Next:** [What the next session should start with]
104+
- **Branch:** `branch-name` | **Last Commit:** `hash`
105+
```
106+
3. Stage and commit with other changes (or amend last commit)
107+
108+
---
109+
110+
## 📊 TOKEN SELF-ASSESSMENT
111+
112+
**Heuristic:** ~4 characters = 1 token. Use this to self-regulate without running scripts.
113+
114+
**Quick reference:**
115+
- 1 line (~80 chars) ≈ 20 tokens
116+
- 1 paragraph (~320 chars) ≈ 80 tokens
117+
- 1 CHANGELOG entry ≈ 60-80 tokens
118+
- 1 DEVLOG compact entry ≈ 50-80 tokens
119+
- 1 DEVLOG incident entry ≈ 80-120 tokens
120+
- 1 DEVLOG standard entry ≈ 150-250 tokens
121+
122+
**Budgets:**
123+
- CHANGELOG: <10,000 tokens
124+
- DEVLOG: <15,000 tokens
125+
- Combined: <25,000 tokens
126+
127+
**Before writing:** Estimate entry size. If file is near budget, archive oldest entries first.
128+
129+
---
130+
131+
## ✏️ ENTRY VERBOSITY
132+
133+
**Three DEVLOG entry formats:**
134+
135+
**Compact format** (default for routine work, ~50-80 tokens):
136+
```
137+
### YYYY-MM-DD: Title
138+
Why/what in 1-2 sentences. Context or rationale.
139+
Files: `file1.py`, `file2.py`
140+
```
141+
142+
**Incident format** (for failures worth learning from, ~80-120 tokens):
143+
```
144+
### YYYY-MM-DD: 🚨 INCIDENT - What failed
145+
**Root Cause:** Why it happened (1-2 sentences)
146+
**Prevention:** How to stop it recurring (1-2 actions)
147+
**Detection:** How to catch it earlier next time (1 action)
148+
Files: `file1.py`, `file2.py` → CHANGELOG: `v1.2.1`
149+
```
150+
151+
**Incident rubric — always qualifies:** security exposure, data loss/corruption, repeated failure (3+), silent failure, rule violation with impact, regression.
152+
153+
**Standard format** (for major decisions, milestones, ~150-250 tokens):
154+
```
155+
### YYYY-MM-DD: Title
156+
**The Situation:** ...
157+
**The Decision:** ...
158+
**Why This Matters:** ...
159+
**Files Changed:** ...
160+
```
161+
162+
**Decision guide:** Security/data/regression → incident. Needs an ADR → standard. Everything else → compact.
163+
164+
---
165+
166+
## 🔗 CROSS-REFERENCES
167+
168+
**When writing entries that relate across files, add navigation hints:**
169+
170+
- CHANGELOG entry with a DEVLOG decision: append `→ DEVLOG YYYY-MM-DD`
171+
- DEVLOG entry referencing a specific version: append `→ CHANGELOG vX.Y.Z`
172+
173+
**Example:**
174+
```
175+
- Fixed token refresh bug. Files: `src/auth.js`. Commit: `abc123` → DEVLOG 2026-02-06
176+
```
177+
178+
Hints are optional - only add when a cross-reference exists.
83179

84180
---
85181

@@ -89,7 +185,9 @@ This rule is ALWAYS active. Violations require immediate self-correction.
89185

90186
**Action:** Archive OLDEST entries first until under budget
91187
1. Move oldest entries to `logs/archive/[FILENAME]-YYYY-MM.md`
92-
2. Re-run validation to confirm
188+
2. Add summary line to the Archive section of the source file:
189+
`- [FILENAME-YYYY-MM.md](archive/FILENAME-YYYY-MM.md) - Brief description of contents`
190+
3. Re-run validation to confirm
93191

94192
**Key:** Archive by TOKEN COUNT, not date. Recent entries may need archiving if over budget.
95193

‎.logfile-config.yml‎

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
# Version tracking - DO NOT EDIT MANUALLY
55
# Updated automatically by update scripts
66
version: "0.2.0"
7-
last_updated: "2026-01-22"
7+
last_updated: "2026-02-06"
88

99
# Profile selection - determines token targets and validation strictness
1010
# Options: solo-developer, team, open-source, startup
@@ -39,8 +39,6 @@ updates:
3939
# Related documents
4040
# These links help AI assistants find relevant documentation
4141
related_docs:
42-
prd: "project/prd.md"
43-
architecture: "project/architecture.md"
42+
prd: "project/specs/prd.md"
4443
workflow: "project/WORKFLOW.md"
45-
roadmap: "project/specs/ROADMAP-REVISED-2025-11.md"
4644

‎logs/CHANGELOG.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -33,6 +33,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
3333

3434
- README rewrite: reframed around agent performance. New tagline ("Make your AI agents rip"), problem/solution sections focus on agent behavior not token bloat, "Why It's Genius" leads with performance outcomes. Added shipped features: session continuity, self-regulating budgets, incident learning, safety tooling. Fixed broken emoji, removed stale "incidents" reference, updated token budgets. Files: `README.md`. Commit: `70b7ad6`
3535

36+
- Dogfood update: synced local LFG install to latest product version. AI rules updated from 115→213 lines (adds session handoff, token self-assessment, entry verbosity, incident format, cross-references, archival summaries). Fixed stale related_docs paths in config. Files: `.augment/rules/log-file-maintenance.md`, `.logfile-config.yml`. Commit: `ec50460`
37+
3638
### Changed
3739

3840
- LFG Schema Proposal revised with tiered approach - Code-Police review accepted Phase 1 (schema), rejected Phase 2/3 (CLI tools, VS Code). Added tiered metadata: Tier 1 inline for CHANGELOG (~18 tokens), Tier 2 condensed block for DEVLOG decisions (~25 tokens), Tier 3 full block for context only. Human readability preserved. Token overhead reduced 46% vs original proposal. Files: `project/docs/proposals/lfg-schema-proposal.md`. Commit: `cfee835`

0 commit comments

Comments
 (0)