Migrate best practices to skynet/best-practices repo

Remove all best-practices topic files and .distill-state.json from
claude-foundations. BESTPRACTICES.md now redirects to the standalone
repo at ~/dev/claude/projects/best-practices/. Remove the now-unnecessary
sync-best-practices.sh script.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

BESTPRACTICES.md

@@ -1,31 +1,9 @@
-> **Note:** Best practices are now maintained in [skynet/best-practices](https://gitea.oreillyit.nz/skynet/best-practices).
-> AI agents with /best-practices mounted should read /best-practices/INDEX.md instead.
-> The content below is kept as a local copy for context-load compatibility.
+# Best Practices
 
-# Best Practices Index
+Best practices have moved to their own repository: **[skynet/best-practices](https://gitea.oreillyit.nz/skynet/best-practices)**
 
-Generalised best practices extracted from real project work. Each topic file is self-contained — read only the files relevant to the current project.
+- **Local clone:** `~/dev/claude/projects/best-practices/`
+- **Index:** `~/dev/claude/BESTPRACTICES.md` (symlink to the clone)
+- **Container agents:** cloned to `/best-practices` by the entrypoint
 
-## Topics
-
-- [Validation & Deployment](best-practices/validation.md) — Validate locally, deploy once; full-chain testing; pre-flight checks
-- [Security Architecture](best-practices/security-architecture.md) — Server boundary rule: no credential crosses to the client; proxy + identity mapping pattern; defense in depth; anti-patterns
-- [Secrets Management](best-practices/secrets-management.md) — SOPS + age, credential handling, file naming, encryption gotchas
-- [Git & Source Control](best-practices/git-source-control.md) — Commit practices, GitOps workflows, remote conventions
-- [Kubernetes Patterns](best-practices/kubernetes.md) — Volume mounts, deployment strategies, naming, bootstrap ordering
-- [Helm Charts](best-practices/helm.md) — Schema validation, version verification, values structure
-- [Ansible](best-practices/ansible.md) — Inventory, templates, idempotency, credential safety
-- [Scripting](best-practices/scripting.md) — Shell conventions, verification scripts, idempotency, colour output
-- [Documentation Standards](best-practices/documentation.md) — CLAUDE.md, MEMORY.md, FUTURE.md, README.md structure and tiered memory
-- [Milestones & Reflections](best-practices/milestones.md) — Milestone workflow, verification, reflection process
-- [Debugging Methodology](best-practices/debugging.md) — Systematic diagnosis, full-chain testing, common pitfalls
-- [Claude Code Skills](best-practices/skills-development.md) — Skill authoring, context injection, tool restrictions
-- [Linting & Formatting](best-practices/linting.md) — Tool choices per language, PostToolUse hook, pre-commit integration, formatter contract
-- [Spec-Driven Development](best-practices/spec-driven-development.md) — Spec structure, requirement numbering, test-first workflow, context tiers, anti-patterns
-- [Test-Driven Development](best-practices/test-driven-development.md) — Edge case discovery, property-based testing, mutation testing, AI agent testing patterns, test architecture
-- [Networking & Infrastructure](best-practices/networking.md) — nftables safety, systemd socket activation, Docker forwarding, TLS SNI vs Host header, wildcard certs
-- [Docker UID Matching](best-practices/docker-uid-matching.md) — UID wrapper entrypoint for mounted volumes, gosu pattern, when to use vs K8s securityContext
-- [Database Selection](best-practices/database-selection.md) — SQLite is not a production database; always use PostgreSQL for services with FQDNs, multiple consumers, or concurrent access
-- [Docker](best-practices/docker.md) — gosu PID 1, GIT_SSH_COMMAND scope, slim image health checks, buildx local images, default users, TTY flags, UID resolution
-- [Octopus Process Templates](best-practices/octopus-process-templates.md) — OCL syntax, step template references, channel scoping, parameters, versioning, Platform Hub patterns
-- [Platform Hub Knowledge Base](PLATFORMHUB.md) — Comprehensive guide: architecture, OCL syntax, template patterns, gotchas, API reference
+Read `BESTPRACTICES.md` in the best-practices repo for the full topic index.