Skip to content

Comments

feat(landscape): add persistent codebase knowledge document#26

Merged
MacAttak merged 8 commits intomainfrom
work/codebase-landscape
Feb 15, 2026
Merged

feat(landscape): add persistent codebase knowledge document#26
MacAttak merged 8 commits intomainfrom
work/codebase-landscape

Conversation

@MacAttak
Copy link
Contributor

@MacAttak MacAttak commented Feb 15, 2026

Summary

  • Add LANDSCAPE.md as a persistent codebase knowledge document — created during init, consumed during design, incrementally updated during learn
  • New protocols/landscape.md defines format, size targets, freshness rules, and update semantics
  • Integrates into existing workflow without adding dependencies or changing anchor document semantics

Acceptance Criteria

# Criterion Status
AC-1.1 Protocol defines LANDSCAPE.md format with required sections PASS
AC-1.2 Size targets: 500-1000 small, 1500-2500 large, 3000 cap PASS
AC-1.3 Freshness: timestamp check, 7-day default, configurable PASS
AC-1.4 Update semantics: full rewrite + incremental merge PASS
AC-1.5 Consumer-agnostic (P4) PASS
AC-1.6 Under 200 tokens (~150 words) PASS
AC-2.1 Reference Documents subsection in context protocol PASS
AC-2.2 LANDSCAPE.md listed with load-on-demand semantics PASS
AC-2.3 Existing Anchor Documents unchanged PASS
AC-2.4 No existing loading strategy modified PASS
AC-3.1 Survey constraint in sw-init after Detection PASS
AC-3.2 Survey uses Glob/Grep/Read, no agent delegation PASS
AC-3.3 Survey optional, user can skip PASS
AC-3.4 Configuration constraint lists LANDSCAPE.md PASS
AC-3.5 sw-init token budget maintained PASS
AC-4.1 sw-design loads LANDSCAPE.md, checks freshness PASS
AC-4.2 Stale refresh with timestamp update PASS
AC-4.3 Missing LANDSCAPE.md handled silently PASS
AC-4.4 sw-design token budget WARN (+13 words, correctness fix)
AC-5.1 Landscape update in sw-learn after Persistence PASS
AC-5.2 Affected module identification, merge, timestamp PASS
AC-5.3 Missing LANDSCAPE.md silently skipped PASS
AC-5.4 User approves landscape changes PASS
AC-5.5 sw-learn token budget decreased PASS
AC-6.1 DESIGN.md documents as reference document PASS
AC-6.2 Lifecycle documented (init/design/learn) PASS
AC-6.3 Anchor Documents language unchanged PASS
AC-6.4 Directory tree includes LANDSCAPE.md PASS

Gate Results

Gate Status Findings (B/W/I)
Build SKIP —
Tests SKIP —
Security PASS 0/0/0
Wiring PASS 0/0/1
Spec WARN 0/1/0

Evidence

🤖 Generated with Claude Code

MacAttak and others added 8 commits February 15, 2026 17:57
@MacAttak @claude
feat(protocols): add landscape protocol for codebase reference document
067ffdf 
Defines format, size targets (3000-word cap), freshness rules (7-day
default), and update semantics for LANDSCAPE.md.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@MacAttak @claude
feat(protocols): add reference documents section with LANDSCAPE.md
a23e5d2 
Adds LANDSCAPE.md as an optional, load-on-demand reference document
separate from anchor documents (Constitution, Charter).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@MacAttak @claude
feat(skills): add survey phase to sw-init for LANDSCAPE.md generation
e08f9bd 
Adds optional codebase survey after detection. Tightened Detection,
Git workflow, and Gate configuration constraints (732 → 654 words).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@MacAttak @claude
feat(skills): add landscape-aware research to sw-design
cc63ea3 
Research phase loads LANDSCAPE.md first if available, refreshes inline
when stale. Tightened Change requests constraint (607 → 610 words).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@MacAttak @claude
feat(skills): add landscape update phase to sw-learn
867b7e5 
After capturing learnings, incrementally updates LANDSCAPE.md for
modules changed in the work unit. Tightened Persistence, Enrichment,
and Compaction constraints (623 → 589 words).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@MacAttak @claude
docs(design): document LANDSCAPE.md as reference document
1e34ccb 
Adds Reference Documents section, LANDSCAPE.md to directory tree,
and landscape protocol to protocols table. Anchor document language
unchanged.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@MacAttak @claude
fix(verify): resolve wiring and spec compliance findings
d321b66 
- Add LANDSCAPE.md to sw-init Configuration constraint (AC-3.4)
- Add explicit timestamp update and missing-case to sw-design refresh (AC-4.2, W5)
- Add protocols/landscape.md to sw-init and sw-design Protocol References (W1, W2)
- Add landscape.md to CLAUDE.md protocols list (W3)
- Update README.md protocol count to 11 (W4)
- Reword sw-learn landscape update to use available tools (W6)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@MacAttak @claude
fix(skills): add Bash to sw-learn allowed-tools for git log access
5e8ea51 
Pre-existing gap surfaced by verify (P11): sw-learn references git log
in Inputs and Discovery but lacked Bash in allowed-tools.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@MacAttak MacAttak merged commit fb62257 into main Feb 15, 2026
2 checks passed
@MacAttak MacAttak deleted the work/codebase-landscape branch February 15, 2026 07:49
@github-actions github-actions bot mentioned this pull request Feb 15, 2026
Merged
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@MacAttak