docs: wipe all documentation for clean reference-docs rewrite#168
Merged
Conversation
User-requested full doc nuke. The existing docs were a mix of
Java-era specs (now obsolete after Phase 6 cutover), point-in-time
plans (Go-port phases 1-6, OOM-fix), and partial v0.4.0-state
references that didn't form a coherent reference. Wiping them for
a single clean rewrite is faster than re-anchoring each file.
Deleted (24 files / ~5.9k lines):
AGENTS.md, CHANGELOG.md, CLAUDE.md, PROJECT_SUMMARY.md,
README.md, SECURITY.md
docs/audits/2026-04-28-serve-path-prod-readiness*.md (2)
docs/codeiq.yml.example
docs/plans/2026-04-2[78]-sub-project-*.md (2)
docs/specs/2026-04-2[78]-*-design.md (2)
docs/superpowers/baselines/2026-04-17/{BASELINE,PHASE-B-EXIT-GATE}.md
docs/superpowers/plans/2026-05-13-enrich-oom-fix.md
shared/runbooks/{aks-oom-quick-fix,aks-read-only-deploy,
engineering-standards,first-time-setup,release-go,release,
rollback,test-strategy}.md
Preserved:
LICENSE — legal artifact
testdata/fixture-minimal/README.md — test fixture content
(exercises detectors)
.github/workflows/* — CI configs, not docs
source code — comments stay with code
.goreleaser.yml — references README.md
via `files:` pattern;
will silent-skip until
README returns
.github/workflows/release-darwin.yml — copies LICENSE/README/
CHANGELOG with
`|| true`; degrades
gracefully
The release pipeline keeps working; release archives just won't
include README/CHANGELOG until the new docs land.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This was referenced May 14, 2026
aksOps
added a commit
that referenced
this pull request
May 14, 2026
…ing (#169) The .goreleaser.yml `files:` entries were bare filenames (`README.md`, `CHANGELOG.md`) which goreleaser treats as required: globbing fails hard when the file doesn't exist: globbing failed for pattern README.md: matching "./README.md": file does not exist This bit v0.4.2 — every release would fail after #168 wiped the docs until the new reference docs land. Switch each bare filename to a glob (`README.md*`, `CHANGELOG.md*`). Goreleaser silently skips patterns that match zero files. The trailing `*` matches the file when present and nothing when absent — gracefully covering both "docs landed" and "docs not yet rewritten" states. `LICENSE*` already used this pattern. No behavior change when a README is present. `release-darwin.yml` already wraps its `cp` commands in `|| true`, so it was unaffected — only goreleaser-side bundling broke. Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>
aksOps
added a commit
that referenced
this pull request
May 14, 2026
User-requested full reference-doc set ahead of stopping codeiq work with Claude Code. Replaces the doc-wipe slate from PR #168 with a coherent, source-grounded reference tree. Created (15 files / ~2,200 lines / ~180 KB): README.md — user-facing entry + badges CLAUDE.md — agent-facing repo guide docs/00-project-overview.md — what / who / status docs/01-local-setup.md — build / test / common issues docs/02-architecture.md — components + tradeoffs docs/03-code-map.md — directory-by-directory tour docs/04-main-flows.md — index / enrich / mcp / review docs/05-configuration.md — env / flags / config files docs/06-data-model.md — Kuzu + SQLite schemas + taxonomy docs/07-integrations.md — Ollama + Sigstore + zero else docs/08-testing.md — strategy + fixtures + perf-gate docs/09-build-deploy-release.md — Goreleaser + cosign keyless docs/10-known-risks-and-todos.md — gotchas / debt / sec-sensitive docs/11-agent-handoff.md — one-stop brief for next agent docs/adr/0001-current-architecture.md — why the shape is what it is Grounding policy: * Every concrete claim points at a file. Uses `path/to/file:line` form where line-level matters. * Anything not directly verified is marked `Inference`. * Anything unknown is marked `Unknown`. * No code changes. Only docs. Co-authored-by: Claude Opus 4.7 <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
1 participant
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.
Summary
User-requested doc nuke ahead of rewriting the reference documentation from scratch.
The existing docs were a mix of Java-era specs (obsolete after Phase 6 cutover), point-in-time plans (Go-port phases 1–6, OOM-fix), and partial v0.4.0-state references that didn't form a coherent reference. Wiping for a single clean rewrite is faster than re-anchoring each file.
Deleted (24 files / ~5.9k lines)
Top-level (6):
`docs/` (10):
`shared/runbooks/` (8):
Preserved
CI graceful degradation (no fixes needed)
The release pipeline keeps working; release archives just won't include README/CHANGELOG until the new docs land.
Test plan
🤖 Generated with Claude Code