place-knowledge

Migrate ADRs, runbooks, and lessons from a personal knowledge store into repository docs directories.

Updated Nov 1, 2024
One-click install
npx skills add https://github.com/mlorentedev/dotfiles --skill place-knowledge-mlorentedev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: place-knowledge
Source: https://github.com/mlorentedev/dotfiles/tree/main/harness/skills/place-knowledge
Command: npx skills add https://github.com/mlorentedev/dotfiles --skill place-knowledge-mlorentedev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Project documentation like ADRs, runbooks, troubleshooting notes, and lessons learned often lives in a personal knowledge store (Obsidian vault, Confluence, Notion), making repositories incomplete and hard to share. This Skill onboards a repository to the knowledge-placement model by moving build/operate docs into the repo's docs/ directory while leaving cross-project knowledge in the store. ## Core Features & Use Cases - Structured docs migration: Copies ADRs, architecture notes, lessons, runbooks, and troubleshooting docs into docs/adr, docs/architecture, docs/lessons, docs/runbooks, and docs/troubleshooting with modular index files. - Cross-reference rewriting: Rewrites links so moved artifacts use relative repo paths while store-only artifacts become plain-text provenance, enforcing the rule that the store links out to repos but never the reverse. - Store-side stubbing and verification: Replaces moved store notes with pointer stubs so inbound wikilinks still resolve, then verifies no live store links remain in docs/ before committing and opening a PR. - Use Case: Onboard an existing repository whose ADRs and runbooks live in a personal vault so the repo becomes self-contained and share-ready for collaborators and agents. ## Quick Start Ask the agent to onboard this repository to the knowledge-placement model by moving its ADRs, runbooks, and lessons from the vault into the repo's docs directory.

Frequently Asked Questions about place-knowledge

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I move ADRs and runbooks from a personal vault into a git repository?

Run the place-knowledge onboarding procedure: branch from a fresh origin default branch, copy ADRs into docs/adr, runbooks into docs/runbooks, and lessons into docs/lessons, then rewrite cross-references and open a pull request.

What documentation should stay in the knowledge store instead of the repo?

Decide and position artifacts such as feasibility studies, brainstorms, and strategy notes stay in the store. Only build and operate docs like ADRs, runbooks, troubleshooting, and lessons move into the repository docs directory.

Does the migration break existing wikilinks in the vault?

No. Each moved note is overwritten in place with a pointer stub using the same basename, so inbound wikilinks in the store still resolve. The store keeps linking out to repos, never the reverse.

When should I not use the knowledge-placement migration?

Skip it when the repository has no remote or local clone, since there is no migration target. Also skip pure strategy or brainstorm content, which belongs in the store rather than the repo.

How are cross-references handled during the docs migration?

Links to artifacts that also moved become relative repo paths, while links to artifacts staying in the store become plain-text provenance with no live link. Code fences and inline code are skipped to avoid corrupting bash or TOML bracket syntax.