chore: add curated Claude knowledge base and un-ignore it#3210
Open
vpetersson wants to merge 4 commits into
Open
chore: add curated Claude knowledge base and un-ignore it#3210vpetersson wants to merge 4 commits into
vpetersson wants to merge 4 commits into
Conversation
- Add force-tracked .claude/skills/ (testbed-qa, anthias-hardware, anthias-viewer, anthias-release) + seed .claude/MEMORY.md, distilled and PII-scrubbed from a retiring agent VM's local memory - Refresh CLAUDE.md: correct the stale layout (src/ tree, server-rendered Django + Alpine/htmx, not React) and add a Working conventions section - Replace the blanket .claude/ ignore with .claude/* + negations so the knowledge base tracks without -f while worktrees and unfiltered local memory stay ignored; keep common worktree folders excluded - Docker images still exclude .claude via .dockerignore Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
- Step-by-step release procedure: bump CalVer across package.json, pyproject.toml and uv.lock (semver form), merge, wait for the master Docker build, tag, publish - Publish flow uses GitHub auto-generated notes first, then a curated summary layered on top - Index it in .claude/MEMORY.md and CLAUDE.md; anthias-release stays the reference, cut-release is the runbook Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
There was a problem hiding this comment.
Pull request overview
This PR adds a curated, PII-scrubbed Claude knowledge base to the repository and updates repo guidance so fresh clones pick up the preserved operational/runbook context, while keeping non-curated local agent state ignored.
Changes:
- Add
.claude/MEMORY.mdplus several.claude/skills/*/SKILL.mdrunbooks (QA, hardware, viewer internals, release ops, and release cutting). - Refresh
CLAUDE.mdto match the currentsrc/layout and the server-rendered Django + Alpine.js/htmx UI architecture. - Update
.gitignoreto ignore.claude/*by default while explicitly tracking the curated knowledge base files.
Reviewed changes
Copilot reviewed 7 out of 8 changed files in this pull request and generated 5 comments.
Show a summary per file
| File | Description |
|---|---|
CLAUDE.md |
Updates architecture + directory layout docs; adds “Project knowledge base” and “Working conventions”. |
.gitignore |
Changes .claude/ ignore strategy to track curated knowledge while ignoring local worktrees/caches. |
.claude/MEMORY.md |
Adds a top-level index/map into the committed skills and key cross-cutting facts. |
.claude/skills/testbed-qa/SKILL.md |
Adds a physical testbed QA runbook and operational validation guidance. |
.claude/skills/cut-release/SKILL.md |
Adds a step-by-step release cutting runbook (CalVer bump + GH release sequencing). |
.claude/skills/anthias-viewer/SKILL.md |
Adds viewer/server architecture notes and known bug/fix mechanisms. |
.claude/skills/anthias-release/SKILL.md |
Adds release/CI/balena/Sentry operational knowledge and pitfalls. |
.claude/skills/anthias-hardware/SKILL.md |
Adds per-board display/codec/rotation/audio operational knowledge. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
- Drop stale "force-added" wording (.gitignore now un-ignores .claude/MEMORY.md and .claude/skills/, so they track normally) - Rephrase "forum #NNNN" -> "forum thread NNNN" so GitHub doesn't auto-link Discourse thread numbers to the wrong PR/issue Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
- Copilot round 2: the seed said "four skills" after cut-release made it five; remove the count so it can't go stale as skills change Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Issues Fixed
Not associated with a tracked issue. This preserves hard-won engineering knowledge from a retiring agent VM before its local memory is lost, and moves it into the repo so a fresh clone picks it up.
Description
Distills a long-running agent's local memory (127 notes) into a curated, PII-scrubbed knowledge base that ships with the repo.
.claude/skills/(testbed-qa,anthias-hardware,anthias-viewer,anthias-release) and a seed.claude/MEMORY.mdmapping them. Skills auto-discover on clone.CLAUDE.md: corrects the stale layout (everything moved undersrc/; the UI is server-rendered Django + Alpine.js/htmx, not React/Redux) and adds a Working conventions section..claude/gitignore with.claude/*+ negations, so the knowledge base tracks without a forced add while git worktrees and unfiltered local memory stay ignored. Common worktree folders remain excluded..claude/is still excluded from Docker images via.dockerignore, so device images are unchanged.All notes were scrubbed of IP addresses, usernames, emails, device UUIDs, tokens, tunnel URLs, and forum handles before inclusion (public repo).
Checklist
🤖 Generated with Claude Code