Migrate relevant context-vault documentation into docs/ #48
Labels
No labels
automerge
bug
dependencies
duplicate
help wanted
invalid
lang
rust
migrations
opencode
question
security
type
documentation
type
enhancement
type
maintenance
type
refactor
vulnerability
wontfix
No milestone
No project
No assignees
1 participant
Notifications
Due date
No due date set.
Blocks
#49 Remove the context-vault skill and command after documentation migration
Personal/nixos-configuration
Reference
Personal/nixos-configuration#48
Loading…
Reference in a new issue
No description provided.
Delete branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Summary
Move documentation relevant to this NixOS configuration from the
context-vaultrepository into a repository-localdocs/directory. This repository should own its documentation without requiring a separate knowledge vault.Scope
Out of scope
Do not delete unrelated context-vault material or remove the source repository. Removing the context-vault skill and command is tracked separately in #49.
Acceptance criteria
docs/, retaining useful context and source attribution where appropriate.README.mdandAGENTS.mdso people and coding agents can discover it.Dependencies
Progress
Completed the initial copy-first migration in the local working tree, following the user's direction to review and change documentation afterward.
docs/: 12 fromprojects/nixos/, 6 fromprojects/martials-network/, and 8 relevant shared patterns. Preserved contents, frontmatter, filenames, and original directory structure byte-for-byte.docs/README.mdwith a complete index and source attribution to context-vault revisionf84e5856c78d21ca0e810b0f291e2decb5b42c9c.README.mdandAGENTS.md, noting that copied material awaits review and does not override current configuration or agent guidance.Validation
cmpverified all 26 copied documents match their source files byte-for-byte.nix fmt -- docs/README.mdpassed with no changes. Copied files were deliberately not reformatted.git diff --checkpassed.Decisions
This is a preservation pass, not completion of every acceptance criterion. Content accuracy, duplication, stale paths/cross-references, and copied Markdown formatting remain for the subsequent review. Changes are uncommitted; no configuration was built or activated. Keep #48 open and #49 blocked until that review is complete.
Metadata validation and normalization are complete for the 26 migrated documents.
Results
architecture=9,patterns=7,errors=6,learnings=3,decisions=1. No invalid values remain.relatedkey.relatededges; 0 non-reciprocal edges (backlinks added).relatedentries still point to documents that were not copied:shell-script-best-practices.md,nix-flake-multi-binary-discovery.md,nix-import-tree-pattern.md, and threewoodpecker-extension/clusterproject docs. These exist in the source vault and are now documented as known unresolved pointers indocs/README.md.docs/projects/nixos/config/architecture.mdand a badpatternspath in the Renovate error doc.created/updateddates were left unchanged because document bodies were not revised.Preservation check
All 26 copied files still have byte-identical bodies to context-vault revision
f84e585; only frontmatter changed.nix fmt -- docsmade no further changes andgit diff --checkis clean.Content review and deciding whether to migrate the six referenced vault documents remain open. Nothing has been committed or activated.
Opened #54 as a WIP pull request for the migration:
WIP: docs: migrate context-vault documentation.It contains the 26 copied documents, the documentation index, the README/AGENTS links, and the metadata normalization. Content review and the six unresolved vault references remain before it is ready to merge.