From fa9603af1107fe6f628d174b5668fda3e41e7287 Mon Sep 17 00:00:00 2001 From: Luong NGUYEN Date: Thu, 25 Dec 2025 00:02:55 +0100 Subject: [PATCH] chore: Archive add-cli-lesson change --- .../proposal.md | 0 .../specs/memory-lesson/spec.md | 0 .../2025-12-24-update-memory-lesson/tasks.md | 46 +++++++++++++++++++ .../changes/update-memory-lesson/tasks.md | 46 ------------------- 4 files changed, 46 insertions(+), 46 deletions(-) rename openspec/changes/{update-memory-lesson => archive/2025-12-24-update-memory-lesson}/proposal.md (100%) rename openspec/changes/{update-memory-lesson => archive/2025-12-24-update-memory-lesson}/specs/memory-lesson/spec.md (100%) create mode 100644 openspec/changes/archive/2025-12-24-update-memory-lesson/tasks.md delete mode 100644 openspec/changes/update-memory-lesson/tasks.md diff --git a/openspec/changes/update-memory-lesson/proposal.md b/openspec/changes/archive/2025-12-24-update-memory-lesson/proposal.md similarity index 100% rename from openspec/changes/update-memory-lesson/proposal.md rename to openspec/changes/archive/2025-12-24-update-memory-lesson/proposal.md diff --git a/openspec/changes/update-memory-lesson/specs/memory-lesson/spec.md b/openspec/changes/archive/2025-12-24-update-memory-lesson/specs/memory-lesson/spec.md similarity index 100% rename from openspec/changes/update-memory-lesson/specs/memory-lesson/spec.md rename to openspec/changes/archive/2025-12-24-update-memory-lesson/specs/memory-lesson/spec.md diff --git a/openspec/changes/archive/2025-12-24-update-memory-lesson/tasks.md b/openspec/changes/archive/2025-12-24-update-memory-lesson/tasks.md new file mode 100644 index 0000000..fa8cef1 --- /dev/null +++ b/openspec/changes/archive/2025-12-24-update-memory-lesson/tasks.md @@ -0,0 +1,46 @@ +## 1. Update Memory Hierarchy Section +- [x] 1.1 Update the memory hierarchy table to include 5 levels (Enterprise, Project, Project Rules, User, Project Local) +- [x] 1.2 Update the mermaid diagram to show the complete hierarchy +- [x] 1.3 Fix Windows Enterprise Policy path from `C:\ProgramData\ClaudeCode\CLAUDE.md` to `C:\Program Files\ClaudeCode\CLAUDE.md` +- [x] 1.4 Add explanation of precedence and loading order + +## 2. Add Modular Rules Section +- [x] 2.1 Create new section "Modular Rules with `.claude/rules/`" +- [x] 2.2 Add directory structure example showing `.claude/rules/` organization +- [x] 2.3 Explain benefits of topic-specific rule files +- [x] 2.4 Add examples of modular rule filenames (code-style.md, testing.md, security.md) + +## 3. Add Path-Specific Rules Section +- [x] 3.1 Create new section "Path-Specific Rules with Glob Patterns" +- [x] 3.2 Explain YAML frontmatter with `paths:` directive +- [x] 3.3 Add table of glob pattern examples (`**/*.ts`, `src/**/*`, etc.) +- [x] 3.4 Include practical example of path-scoped API rules + +## 4. Add Project Local Memory Section +- [x] 4.1 Add explanation of `CLAUDE.local.md` file +- [x] 4.2 Explain auto-gitignore behavior +- [x] 4.3 Add use case examples (personal preferences on shared projects) + +## 5. Add Symlink Support Section +- [x] 5.1 Add section on sharing rules across projects using symlinks +- [x] 5.2 Include bash examples for creating symlinks to shared rules + +## 6. Update Memory Lookup Algorithm +- [x] 6.1 Add detailed explanation of recursive upward search +- [x] 6.2 Explain subtree discovery behavior +- [x] 6.3 Add example of which files are loaded from different directories + +## 7. Update Best Practices +- [x] 7.1 Add best practices for `.claude/rules/` organization +- [x] 7.2 Add guidelines for using path-specific rules sparingly +- [x] 7.3 Add tips for symlink-based rule sharing + +## 8. Update Directory Structure Example +- [x] 8.1 Update the directory structure to show `.claude/rules/` hierarchy +- [x] 8.2 Include subdirectory examples (frontend/, backend/) + +## 9. Review and Polish +- [x] 9.1 Ensure all mermaid diagrams are updated +- [x] 9.2 Review table formatting consistency +- [x] 9.3 Update "Official Documentation" links if needed +- [x] 9.4 Verify all code examples are accurate diff --git a/openspec/changes/update-memory-lesson/tasks.md b/openspec/changes/update-memory-lesson/tasks.md deleted file mode 100644 index 84c2d66..0000000 --- a/openspec/changes/update-memory-lesson/tasks.md +++ /dev/null @@ -1,46 +0,0 @@ -## 1. Update Memory Hierarchy Section -- [ ] 1.1 Update the memory hierarchy table to include 5 levels (Enterprise, Project, Project Rules, User, Project Local) -- [ ] 1.2 Update the mermaid diagram to show the complete hierarchy -- [ ] 1.3 Fix Windows Enterprise Policy path from `C:\ProgramData\ClaudeCode\CLAUDE.md` to `C:\Program Files\ClaudeCode\CLAUDE.md` -- [ ] 1.4 Add explanation of precedence and loading order - -## 2. Add Modular Rules Section -- [ ] 2.1 Create new section "Modular Rules with `.claude/rules/`" -- [ ] 2.2 Add directory structure example showing `.claude/rules/` organization -- [ ] 2.3 Explain benefits of topic-specific rule files -- [ ] 2.4 Add examples of modular rule filenames (code-style.md, testing.md, security.md) - -## 3. Add Path-Specific Rules Section -- [ ] 3.1 Create new section "Path-Specific Rules with Glob Patterns" -- [ ] 3.2 Explain YAML frontmatter with `paths:` directive -- [ ] 3.3 Add table of glob pattern examples (`**/*.ts`, `src/**/*`, etc.) -- [ ] 3.4 Include practical example of path-scoped API rules - -## 4. Add Project Local Memory Section -- [ ] 4.1 Add explanation of `CLAUDE.local.md` file -- [ ] 4.2 Explain auto-gitignore behavior -- [ ] 4.3 Add use case examples (personal preferences on shared projects) - -## 5. Add Symlink Support Section -- [ ] 5.1 Add section on sharing rules across projects using symlinks -- [ ] 5.2 Include bash examples for creating symlinks to shared rules - -## 6. Update Memory Lookup Algorithm -- [ ] 6.1 Add detailed explanation of recursive upward search -- [ ] 6.2 Explain subtree discovery behavior -- [ ] 6.3 Add example of which files are loaded from different directories - -## 7. Update Best Practices -- [ ] 7.1 Add best practices for `.claude/rules/` organization -- [ ] 7.2 Add guidelines for using path-specific rules sparingly -- [ ] 7.3 Add tips for symlink-based rule sharing - -## 8. Update Directory Structure Example -- [ ] 8.1 Update the directory structure to show `.claude/rules/` hierarchy -- [ ] 8.2 Include subdirectory examples (frontend/, backend/) - -## 9. Review and Polish -- [ ] 9.1 Ensure all mermaid diagrams are updated -- [ ] 9.2 Review table formatting consistency -- [ ] 9.3 Update "Official Documentation" links if needed -- [ ] 9.4 Verify all code examples are accurate