Update claude-custom + docs for repo renames #174

New issue

Closed

opened 2026-03-27 05:04:37 +00:00 by forgejo_admin · 1 comment

forgejo_admin commented

2026-03-27 05:04:37 +00:00

Contributor

Type

Feature

Lineage

Final cleanup after all three repo renames complete (pal-e-api, pal-e-sdk, pal-e-mcp). Moved from forgejo_admin/pal-e-app#62 (wrong repo).

Repo

forgejo_admin/claude-custom

User Story

As the platform
I want all cross-references updated after repo renames
So that hooks, agents, docs, and memory files reflect the new names

Context

After renaming pal-e-docs → pal-e-api, pal-e-docs-sdk → pal-e-sdk, and pal-e-docs-mcp → pal-e-mcp, references need updating across claude-custom and pal-e-docs notes. Note: MCP tool prefix mcp__pal-e-docs__* stays unchanged (project name). MCP server key in settings.json stays pal-e-docs.

File Targets

claude-custom hooks (env vars and repo paths — NOT tool matchers):

hooks/session-start-context.sh — PAL_E_DOCS_URL → PAL_E_API_URL
hooks/check-note-template.sh — PAL_E_DOCS_URL → PAL_E_API_URL
hooks/check-pr-template.sh — PAL_E_DOCS_URL → PAL_E_API_URL
hooks/check-issue-template.sh — PAL_E_DOCS_URL → PAL_E_API_URL
hooks/board-item-on-merge.sh — PAL_E_DOCS_URL → PAL_E_API_URL
hooks/session-start-board-sync.sh — PAL_E_DOCS_URL → PAL_E_API_URL
hooks/cleanup-worktrees.sh — $HOME/pal-e-docs → $HOME/pal-e-api, $HOME/pal-e-docs-sdk → $HOME/pal-e-sdk, $HOME/pal-e-docs-mcp → $HOME/pal-e-mcp
hooks/block-dottie-code-writes.sh — repo paths: pal-e-docs → pal-e-api, pal-e-docs-sdk → pal-e-sdk, pal-e-docs-mcp → pal-e-mcp
hooks/inject-subagent-context.sh — prose references to pal-e-docs (the repo, not the project)
hooks/stop-doc-checkin.sh — prose references
hooks/remind-review-loop.sh — prose references

claude-custom agents:

agents/betty-sue.md — repo path references
agents/dev.md — repo path references
agents/qa.md — repo path references
agents/dottie.md — repo path references, description text
agents/penny.md — repo path references

claude-custom skills:

skills/review-ticket/SKILL.md — any repo references
skills/plan/SKILL.md — any repo references

claude-custom root:

CLAUDE.md — repo location references
README.md — repo references

Memory files:

~/.claude/projects/-home-ldraney-pal-e-platform/memory/MEMORY.md — repo path references
~/.claude/projects/-home-ldraney-pal-e-docs/memory/MEMORY.md — repo path references
~/.claude/projects/-home-ldraney-pal-e-services/memory/MEMORY.md — repo path references
Individual memory .md files referencing old repo names

pal-e-docs notes (via MCP, not file writes):

project-pal-e-docs — repos table (update URLs and names), architecture diagrams (3 Mermaid diagrams reference pal-e-docs-mcp node and pal-e-docs namespace)
convention-sveltekit-spa — any repo references
worktree-workflow — remote conventions table
Any other notes referencing old repo names

Other repos' CLAUDE.md files:

~/pal-e-app/CLAUDE.md — repo references
~/pal-e-services/CLAUDE.md — repo references
~/minio-sdk/CLAUDE.md — references "pal-e-docs-sdk patterns"

Files the agent should NOT touch:

MCP tool matchers in hooks — mcp__pal-e-docs__* stays
settings.json MCP server key — stays pal-e-docs
disallowedTools lists in agents — tool prefix stays
~/.mcp.json — handled in MCP rename ticket #441

Acceptance Criteria

grep -r 'PAL_E_DOCS_URL' ~/claude-custom/hooks/ returns 0 matches\n- [ ] grep -r 'pal-e-docs-sdk' ~/claude-custom/ returns 0 matches (repo refs only)\n- [ ] grep -r 'pal-e-docs-mcp' ~/claude-custom/ returns 0 matches\n- [ ] grep -r '$HOME/pal-e-docs[^-]' ~/claude-custom/hooks/ returns 0 matches (but mcp__pal-e-docs__ still present)\n- [ ] pal-e-docs project page repos table shows pal-e-api, pal-e-sdk, pal-e-mcp\n- [ ] Architecture diagrams updated with new names\n- [ ] Session starts without errors after changes\n- [ ] All hooks fire correctly\n\n### Test Expectations\n- [ ] Fresh session starts cleanly\n- [ ] All MCP tools respond (tool prefix unchanged)\n- [ ] grep -rn 'PAL_E_DOCS_URL' ~/claude-custom/hooks/ returns empty\n- Run command: grep -c 'pal-e-docs-sdk\\|pal-e-docs-mcp' ~/claude-custom/hooks/*.sh ~/claude-custom/agents/*.md\n\n### Constraints\n- MUST preserve mcp__pal-e-docs__* tool prefix everywhere\n- MUST preserve pal-e-docs as MCP server key in settings.json\n- All three repo renames must complete before this ticket starts\n- Test with a fresh session after changes\n- claude-custom has uncommitted changes — commit or stash before branching\n\n### Checklist\n- [ ] PR opened (claude-custom)\n- [ ] pal-e-docs notes updated via MCP\n- [ ] Memory files updated\n- [ ] Other repos' CLAUDE.md updated\n- [ ] Tests pass\n- [ ] No unrelated changes\n\n### Related\n- forgejo_admin/pal-e-docs#217 — API rename (prerequisite)\n- forgejo_admin/pal-e-docs-sdk#38 — SDK rename (prerequisite)\n- forgejo_admin/pal-e-docs-mcp#50 — MCP rename (prerequisite)\n- phase-pal-e-docs-repo-renames — deferred phase this completes"}

### Type Feature ### Lineage Final cleanup after all three repo renames complete (pal-e-api, pal-e-sdk, pal-e-mcp). Moved from forgejo_admin/pal-e-app#62 (wrong repo). ### Repo `forgejo_admin/claude-custom` ### User Story As the platform I want all cross-references updated after repo renames So that hooks, agents, docs, and memory files reflect the new names ### Context After renaming pal-e-docs → pal-e-api, pal-e-docs-sdk → pal-e-sdk, and pal-e-docs-mcp → pal-e-mcp, references need updating across claude-custom and pal-e-docs notes. Note: MCP tool prefix `mcp__pal-e-docs__*` stays unchanged (project name). MCP server key in settings.json stays `pal-e-docs`. ### File Targets claude-custom hooks (env vars and repo paths — NOT tool matchers): - `hooks/session-start-context.sh` — `PAL_E_DOCS_URL` → `PAL_E_API_URL` - `hooks/check-note-template.sh` — `PAL_E_DOCS_URL` → `PAL_E_API_URL` - `hooks/check-pr-template.sh` — `PAL_E_DOCS_URL` → `PAL_E_API_URL` - `hooks/check-issue-template.sh` — `PAL_E_DOCS_URL` → `PAL_E_API_URL` - `hooks/board-item-on-merge.sh` — `PAL_E_DOCS_URL` → `PAL_E_API_URL` - `hooks/session-start-board-sync.sh` — `PAL_E_DOCS_URL` → `PAL_E_API_URL` - `hooks/cleanup-worktrees.sh` — `$HOME/pal-e-docs` → `$HOME/pal-e-api`, `$HOME/pal-e-docs-sdk` → `$HOME/pal-e-sdk`, `$HOME/pal-e-docs-mcp` → `$HOME/pal-e-mcp` - `hooks/block-dottie-code-writes.sh` — repo paths: `pal-e-docs` → `pal-e-api`, `pal-e-docs-sdk` → `pal-e-sdk`, `pal-e-docs-mcp` → `pal-e-mcp` - `hooks/inject-subagent-context.sh` — prose references to pal-e-docs (the repo, not the project) - `hooks/stop-doc-checkin.sh` — prose references - `hooks/remind-review-loop.sh` — prose references claude-custom agents: - `agents/betty-sue.md` — repo path references - `agents/dev.md` — repo path references - `agents/qa.md` — repo path references - `agents/dottie.md` — repo path references, description text - `agents/penny.md` — repo path references claude-custom skills: - `skills/review-ticket/SKILL.md` — any repo references - `skills/plan/SKILL.md` — any repo references claude-custom root: - `CLAUDE.md` — repo location references - `README.md` — repo references Memory files: - `~/.claude/projects/-home-ldraney-pal-e-platform/memory/MEMORY.md` — repo path references - `~/.claude/projects/-home-ldraney-pal-e-docs/memory/MEMORY.md` — repo path references - `~/.claude/projects/-home-ldraney-pal-e-services/memory/MEMORY.md` — repo path references - Individual memory .md files referencing old repo names pal-e-docs notes (via MCP, not file writes): - `project-pal-e-docs` — repos table (update URLs and names), architecture diagrams (3 Mermaid diagrams reference `pal-e-docs-mcp` node and `pal-e-docs` namespace) - `convention-sveltekit-spa` — any repo references - `worktree-workflow` — remote conventions table - Any other notes referencing old repo names Other repos' CLAUDE.md files: - `~/pal-e-app/CLAUDE.md` — repo references - `~/pal-e-services/CLAUDE.md` — repo references - `~/minio-sdk/CLAUDE.md` — references \"pal-e-docs-sdk patterns\" Files the agent should NOT touch: - MCP tool matchers in hooks — `mcp__pal-e-docs__*` stays - `settings.json` MCP server key — stays `pal-e-docs` - `disallowedTools` lists in agents — tool prefix stays - `~/.mcp.json` — handled in MCP rename ticket #441 ### Acceptance Criteria - [ ] `grep -r 'PAL_E_DOCS_URL' ~/claude-custom/hooks/` returns 0 matches\n- [ ] `grep -r 'pal-e-docs-sdk' ~/claude-custom/` returns 0 matches (repo refs only)\n- [ ] `grep -r 'pal-e-docs-mcp' ~/claude-custom/` returns 0 matches\n- [ ] `grep -r '$HOME/pal-e-docs[^-]' ~/claude-custom/hooks/` returns 0 matches (but `mcp__pal-e-docs__` still present)\n- [ ] pal-e-docs project page repos table shows pal-e-api, pal-e-sdk, pal-e-mcp\n- [ ] Architecture diagrams updated with new names\n- [ ] Session starts without errors after changes\n- [ ] All hooks fire correctly\n\n### Test Expectations\n- [ ] Fresh session starts cleanly\n- [ ] All MCP tools respond (tool prefix unchanged)\n- [ ] `grep -rn 'PAL_E_DOCS_URL' ~/claude-custom/hooks/` returns empty\n- Run command: `grep -c 'pal-e-docs-sdk\\|pal-e-docs-mcp' ~/claude-custom/hooks/*.sh ~/claude-custom/agents/*.md`\n\n### Constraints\n- MUST preserve `mcp__pal-e-docs__*` tool prefix everywhere\n- MUST preserve `pal-e-docs` as MCP server key in settings.json\n- All three repo renames must complete before this ticket starts\n- Test with a fresh session after changes\n- claude-custom has uncommitted changes — commit or stash before branching\n\n### Checklist\n- [ ] PR opened (claude-custom)\n- [ ] pal-e-docs notes updated via MCP\n- [ ] Memory files updated\n- [ ] Other repos' CLAUDE.md updated\n- [ ] Tests pass\n- [ ] No unrelated changes\n\n### Related\n- `forgejo_admin/pal-e-docs#217` — API rename (prerequisite)\n- `forgejo_admin/pal-e-docs-sdk#38` — SDK rename (prerequisite)\n- `forgejo_admin/pal-e-docs-mcp#50` — MCP rename (prerequisite)\n- `phase-pal-e-docs-repo-renames` — deferred phase this completes"} </invoke>

forgejo_admin commented

2026-03-27 05:16:42 +00:00

Author

Contributor

Scope Review: READY

Review note: review-444-2026-03-26

Re-review after full rewrite. All 6 issues from the previous review (wrong repo, missing file targets, missing MEMORY.md files, minio-sdk blast radius, unspecified architecture diagrams, acceptance criteria gaps) are resolved. Every file target verified against the filesystem and pal-e-docs. Template 100% complete, traceability triangle complete, acceptance criteria machine-testable. Ready to move backlog -> todo (blocked by 3 prerequisite rename tickets: #439, #440, #441).

## Scope Review: READY Review note: `review-444-2026-03-26` Re-review after full rewrite. All 6 issues from the previous review (wrong repo, missing file targets, missing MEMORY.md files, minio-sdk blast radius, unspecified architecture diagrams, acceptance criteria gaps) are resolved. Every file target verified against the filesystem and pal-e-docs. Template 100% complete, traceability triangle complete, acceptance criteria machine-testable. Ready to move backlog -> todo (blocked by 3 prerequisite rename tickets: #439, #440, #441).