m038/intotheeast-com
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: fix all internal cross-references after restructure

Browse Source
This commit is contained in:
Mischa
2026-06-21 12:48:04 +02:00
parent 93aa6d9b42
commit 65597de00d
29 changed files with 4738 additions and 85 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/superpowers/plans/2026-06-21-documentation-restructure.md
+26 -26
View File
@@ -11,7 +11,7 @@
## Global Constraints
- All file moves use `git mv` — never `mv` — so git history is preserved.
- The existing spec file (`docs/superpowers/specs/2026-06-21-documentation-restructure-design.md`) is itself one of the files being moved — move it in Task 1 with the rest.
- The existing spec file (`docs/working/specs/2026-06-21-documentation-restructure-design.md`) is itself one of the files being moved — move it in Task 1 with the rest.
- Do NOT modify any file inside `user/` — that is a separate git repo.
- Do NOT touch memory files outside of Task 9.
- CLAUDE.md lives at repo root and stays there.
@@ -43,12 +43,12 @@ mkdir -p /home/mischa/Nextcloud/Projects/travel-blog-intotheeast/docs/research
cd /home/mischa/Nextcloud/Projects/travel-blog-intotheeast
# All specs
for f in docs/superpowers/specs/*.md; do
for f in docs/working/specs/*.md; do
git mv "$f" "docs/working/specs/$(basename "$f")"
done
# All plans
for f in docs/superpowers/plans/*.md; do
for f in docs/working/plans/*.md; do
git mv "$f" "docs/working/plans/$(basename "$f")"
done
```
@@ -57,10 +57,10 @@ done
```bash
cd /home/mischa/Nextcloud/Projects/travel-blog-intotheeast
git mv docs/milestone-1-spec.md docs/working/milestones/milestone-1.md
git mv docs/milestone-2-spec.md docs/working/milestones/milestone-2.md
git mv docs/milestone-3-spec.md docs/working/milestones/milestone-3.md
git mv docs/milestone-4-spec.md docs/working/milestones/milestone-4.md
git mv docs/working/milestones/milestone-1.md docs/working/milestones/milestone-1.md
git mv docs/working/milestones/milestone-2.md docs/working/milestones/milestone-2.md
git mv docs/working/milestones/milestone-3.md docs/working/milestones/milestone-3.md
git mv docs/working/milestones/milestone-4.md docs/working/milestones/milestone-4.md
```
- [ ] **Step 4: Move QA docs**
@@ -103,10 +103,10 @@ rmdir docs/design # now empty
```bash
cd /home/mischa/Nextcloud/Projects/travel-blog-intotheeast
git mv docs/posting-pipeline.md docs/guides/posting.md
git mv docs/guides/posting.md docs/guides/posting.md
```
- [ ] **Step 9: Verify — no files remain at docs/ root, no docs/superpowers/ exists**
- [ ] **Step 9: Verify — no files remain at docs/ root, no docs/working/ exists**
```bash
find /home/mischa/Nextcloud/Projects/travel-blog-intotheeast/docs -maxdepth 1 -type f
@@ -137,27 +137,27 @@ git commit -m "docs: restructure docs/ into guides/ reference/ working/ research
**Files:**
- Modify: all files under `docs/working/` and `docs/research/` that reference old paths
After the moves, links inside plan and spec files still point to old paths like `docs/superpowers/plans/...` and `docs/milestone-1-spec.md`. This task fixes them all.
After the moves, links inside plan and spec files still point to old paths like `docs/working/plans/...` and `docs/working/milestones/milestone-1.md`. This task fixes them all.
- [ ] **Step 1: Replace docs/superpowers/specs/ references**
- [ ] **Step 1: Replace docs/working/specs/ references**
```bash
cd /home/mischa/Nextcloud/Projects/travel-blog-intotheeast
grep -rl "docs/superpowers/specs/" docs/ | xargs sed -i 's|docs/superpowers/specs/|docs/working/specs/|g'
grep -rl "docs/working/specs/" docs/ | xargs sed -i 's|docs/working/specs/|docs/working/specs/|g'
```
- [ ] **Step 2: Replace docs/superpowers/plans/ references**
- [ ] **Step 2: Replace docs/working/plans/ references**
```bash
cd /home/mischa/Nextcloud/Projects/travel-blog-intotheeast
grep -rl "docs/superpowers/plans/" docs/ | xargs sed -i 's|docs/superpowers/plans/|docs/working/plans/|g'
grep -rl "docs/working/plans/" docs/ | xargs sed -i 's|docs/working/plans/|docs/working/plans/|g'
```
- [ ] **Step 3: Replace docs/superpowers/ catch-all (any remaining bare references)**
- [ ] **Step 3: Replace docs/working/ catch-all (any remaining bare references)**
```bash
cd /home/mischa/Nextcloud/Projects/travel-blog-intotheeast
grep -rl "docs/superpowers/" docs/ | xargs sed -i 's|docs/superpowers/|docs/working/|g'
grep -rl "docs/working/" docs/ | xargs sed -i 's|docs/working/|docs/working/|g'
```
- [ ] **Step 4: Replace milestone spec references**
@@ -181,16 +181,16 @@ grep -rl "docs/posting-pipeline" docs/ | xargs sed -i 's|docs/posting-pipeline\.
```bash
cd /home/mischa/Nextcloud/Projects/travel-blog-intotheeast
sed -i 's|docs/superpowers/specs/|docs/working/specs/|g' CLAUDE.md
sed -i 's|docs/superpowers/plans/|docs/working/plans/|g' CLAUDE.md
sed -i 's|docs/superpowers/|docs/working/|g' CLAUDE.md
sed -i 's|docs/working/specs/|docs/working/specs/|g' CLAUDE.md
sed -i 's|docs/working/plans/|docs/working/plans/|g' CLAUDE.md
sed -i 's|docs/working/|docs/working/|g' CLAUDE.md
```
- [ ] **Step 7: Verify no old paths remain**
```bash
cd /home/mischa/Nextcloud/Projects/travel-blog-intotheeast
grep -r "docs/superpowers/" docs/ CLAUDE.md
grep -r "docs/working/" docs/ CLAUDE.md
# Expected: no output
grep -r "docs/milestone-[0-9]-spec" docs/ CLAUDE.md
# Expected: no output
@@ -794,7 +794,7 @@ Full setup guide: [`docs/guides/local-setup.md`](docs/guides/local-setup.md)
Specs: `docs/working/specs/YYYY-MM-DD-<topic>-design.md`
Plans: `docs/working/plans/YYYY-MM-DD-<topic>.md`
The brainstorming and writing-plans skills default to `docs/superpowers/`; these lines override that default.
The brainstorming and writing-plans skills default to `docs/working/`; these lines override that default.
```
- [ ] **Step 3: Verify CLAUDE.md**
@@ -1016,7 +1016,7 @@ git commit -m "docs: add architecture overview reference"
**Files:**
- Modify: 4 memory files in `~/.claude/projects/-home-mischa-Nextcloud-Projects-travel-blog-intotheeast/memory/`
Four memory files still reference `docs/superpowers/` paths. Update them to `docs/working/`.
Four memory files still reference `docs/working/` paths. Update them to `docs/working/`.
- [ ] **Step 1: Identify affected lines**
@@ -1032,9 +1032,9 @@ grep -n "docs/superpowers" "$MEMORY_DIR/MEMORY.md" "$MEMORY_DIR/feedback-plan-ex
MEMORY_DIR="/home/mischa/.claude/projects/-home-mischa-Nextcloud-Projects-travel-blog-intotheeast/memory"
for f in "$MEMORY_DIR/MEMORY.md" "$MEMORY_DIR/feedback-plan-execution-gap.md" \
"$MEMORY_DIR/project-story-mode-and-maplibre.md" "$MEMORY_DIR/project-homepage-redesign.md"; do
sed -i 's|docs/superpowers/specs/|docs/working/specs/|g' "$f"
sed -i 's|docs/superpowers/plans/|docs/working/plans/|g' "$f"
sed -i 's|docs/superpowers/|docs/working/|g' "$f"
sed -i 's|docs/working/specs/|docs/working/specs/|g' "$f"
sed -i 's|docs/working/plans/|docs/working/plans/|g' "$f"
sed -i 's|docs/working/|docs/working/|g' "$f"
done
```
@@ -1055,7 +1055,7 @@ Verify MEMORY.md now reads correctly:
```bash
grep "plans\|specs\|superpowers\|working" \
"/home/mischa/.claude/projects/-home-mischa-Nextcloud-Projects-travel-blog-intotheeast/memory/MEMORY.md"
# Expected: all plan/spec references point to docs/working/, none to docs/superpowers/
# Expected: all plan/spec references point to docs/working/, none to docs/working/
```
- [ ] **Step 5: Final verification — complete restructure**