Convert the current working directory into a task-local LLM-maintained wiki.
Use when the user wants to organize project knowledge, ingest files or URLs into
a local markdown wiki, bootstrap a wiki structure in-place, maintain an existing
mini wiki, or build a repo-scoped knowledge base instead of a giant global vault.
Also use when scientific papers, PDFs, TeX bundles, bibliographies, or research
corpora should be ingested into a maintained local wiki with provenance and
citations, subject to extraction quality and available metadata.
Trigger on phrases like "wiki this repo", "ingest raw/", "build a local wiki",
"maintain this knowledge base", "turn this directory into an LLM wiki", or when
repeated project knowledge needs to compound across sessions. DO NOT TRIGGER when:
the user only wants a one-shot summary, a global PKM redesign, or generic markdown
cleanup with no persistent wiki intent.
Convert the current working directory into a task-local LLM-maintained wiki.
Use when the user wants to organize project knowledge, ingest files or URLs into
a local markdown wiki, bootstrap a wiki structure in-place, maintain an existing
mini wiki, or build a repo-scoped knowledge base instead of a giant global vault.
Also use when scientific papers, PDFs, TeX bundles, bibliographies, or research
corpora should be ingested into a maintained local wiki with provenance and
citations, subject to extraction quality and available metadata.
Trigger on phrases like "wiki this repo", "ingest raw/", "build a local wiki",
"maintain this knowledge base", "turn this directory into an LLM wiki", or when
repeated project knowledge needs to compound across sessions. DO NOT TRIGGER when:
the user only wants a one-shot summary, a global PKM redesign, or generic markdown
cleanup with no persistent wiki intent.
Turn the current working directory into a mini LLM wiki that compounds project knowledge over time.
The key difference from a giant second-brain vault is scope discipline: this skill treats the active task directory as the wiki boundary unless the user explicitly asks for something broader.
Core Rule
The working directory is the wiki.
Do not assume one universal knowledge base.
Do not create a sprawling personal-vault taxonomy unless the user asks.
Do not flatten the wiki into one giant markdown file.
Do build a small, legible, repo-local structure that helps future agents and humans navigate the task.
If the user gives you one project, one working directory, or one repo, then default to a .
task-local wiki
Locality boundary rules
Never create or reorganize wiki content outside the current working directory unless the user explicitly expands scope.
In a monorepo, default to the subproject or folder the user is actively working in, not the whole monorepo, unless they clearly ask for repo-wide coverage.
Do not silently pull in parent-directory PKM structure, sibling projects, or a pre-existing personal vault.
If the boundary is ambiguous, prefer the narrowest valid scope and state that assumption in the created schema/wiki-rules.md.
When to Use
Use this skill when the user wants any of the following:
bootstrap a wiki in the current repo or task folder
ingest new sources dropped into raw/
ingest scientific papers, PDFs, TeX bundles, bibliographies, or already-converted paper Markdown into a local research wiki
keep summaries, concepts, decisions, entities, and references synchronized over time
answer project questions against a persistent local markdown knowledge base
lint or maintain an existing local wiki
organize research, due diligence, product notes, technical docs, meeting notes, or mixed-source project knowledge without building a global PKM system
Do not use this skill when:
the user only wants a one-shot summary or memo
the task is ordinary docs cleanup with no persistent knowledge workflow
the user explicitly wants a cross-project or personal-vault redesign
there is no desire to maintain a persistent markdown artifact
Operating Modes
0. Novice Socratic onboarding mode
Use when the user wants a local wiki but sounds uncertain, starts from an empty folder, asks "how do I use this?", or would be overwhelmed by implementation details. This is the default first-run experience for new users.
Your job:
hide internal mechanics at first; do not open with folder taxonomy, schema rules, bridge packets, Graphify, graph databases, or vault concepts
ask only the minimum useful questions, then act
default to this exact three-question onboarding script:
I can organize this folder into a maintained local wiki. I will keep the internal structure out of your way first.
1. What should this wiki remember over time?
2. What source material exists now, and what kind of sources will keep arriving?
3. How autonomous should I be while organizing it?
A) Do it and show results
B) Show key takeaways before shaping
C) Process one source at a time with review
use adaptive questioning: stop after those three if there is enough signal; ask follow-ups only when execution would otherwise be fake-grounded
if the folder is empty or has almost no sources, offer a starter pack first, then ask for seed content:
personal knowledge
research/deep dive
project handoff
book/course notes
business/team wiki
then: "Give me three things this wiki should remember first."
after bootstrapping, point the user to the single start page (wiki/home.md)
mention bridge/promotion, graph lenses, global export, or external tools only after the first useful wiki exists or when the user explicitly asks about cross-project reuse or relationship maps
Non-goals for novice mode:
do not make the user learn raw/wiki/schema/bridge vocabulary before the first useful result
do not force more than three questions unless ambiguity blocks execution
do not silently write into a global wiki, graph database, external vault, sibling repo, or external store
do not modify raw source files
Agent decision boundaries
The agent may decide these without asking once the user has answered the novice onboarding questions or provided enough source context:
local folder/page naming inside the current working directory
whether to create or update topic, entity, source, index, home, schema, or log pages
how to summarize, link, and route source material into the local wiki
when to mark uncertainty, contradictions, weak provenance, or review-needed items
whether to draft a local bridge packet as a candidate artifact
The agent must ask for explicit approval before:
writing outside the current working directory
exporting to a global wiki, another repository, an external vault, a graph database, or any external system
modifying raw source files
doing destructive or large-scale reorganization
turning an optional graph/relationship lens into a dependency
Public-repo portability and privacy rules
This skill is meant to be cloned or forked by many users. Keep docs, examples, templates, and evals universal:
use neutral placeholders such as <repo-url>, <project-name>, <source-file>, and <destination-wiki>
do not include personal names, private paths, private chat exports, credentials, tokens, API keys, machine-specific paths, or organization-internal examples
examples should work for an arbitrary project directory, not one user’s local setup
when discussing sensitive inputs, say how to preserve provenance and boundaries without copying private raw content into reusable templates
Optional graph / relationship lens
Graph-style analysis can be useful after a wiki has enough pages to analyze relationships. Treat it as an optional advanced lens, not a first-run requirement. A graph-compatible workflow may read the maintained local wiki, produce relationship maps or reports inside the current working directory, and feed useful findings back into local topic pages or bridge candidates. It must not require a graph backend and must not write to external stores without explicit approval.
1. Bootstrap mode
Use when the working directory has no clear wiki structure yet.
Your job:
inspect what already exists
create the smallest useful wiki structure
preserve existing docs and point to them instead of duplicating them
seed a home page, index, and only the minimum grounded pages needed
write down the chosen locality boundary in schema/wiki-rules.md
2. Ingest mode
Use when the user adds new files, notes, exports, or URLs into raw/.
Your job:
treat raw/ as immutable source material
extract useful knowledge into the wiki
preserve provenance for claims and summaries
update related pages incrementally rather than rewriting everything
2a. Scientific paper ingest mode
Use this advanced ingest sub-mode when raw/ contains scientific papers or research corpora: PDFs, TeX/LaTeX bundles, arXiv source exports, already-converted paper Markdown, .bib files, supplements, figures, tables, or curated bibliography exports.
This mode borrows structured research-wiki patterns without turning the local wiki into a fixed global research platform.
Your job:
keep original paper files and TeX bundles immutable under raw/
convert or linearize sources only into derived working files or wiki notes, never by rewriting raw inputs
create or update one stable paper source note per paper or source bundle, preferably using assets/paper-source-note-template.md when available
extract bibliographic metadata when available: title, authors, venue, year, DOI, arXiv ID, source files, bibliography file, and citation-source confidence
preserve paper structure where extraction quality allows: abstract, problem, method, assumptions, datasets, experiments, results, limitations, open questions, figures/tables, equations, and references
route durable concepts, methods, datasets, claims, limitations, and open questions into existing topic/shared pages instead of creating a page for every section
run a deduplication pass before creating new topic/entity pages: compare intended page titles and claims against existing index/topic/source pages; merge when overlap is likely
use paper importance to limit wiki growth: low-importance papers should usually create at most one new topic and one new claim/concept; high-importance papers may justify more, but only when navigation improves
record uncertainty for missing metadata, unresolved TeX macros, broken includes, incomplete bibliography, OCR/conversion artifacts, inaccessible figures, weak claims, or contradicted results
update wiki/index.md, wiki/home.md, and log/log.md only for real persistent additions or changes
Optional local research artifacts, created only when useful and inside the current working directory:
.ingest-manifest.json for resumable batch paper ingestion
wiki/graph/edges.jsonl for semantic relationships such as builds_on, uses_method, supports, contradicts, extends, or replicates
wiki/graph/citations.jsonl for bibliographic citation edges from parsed .bib, paper references, Semantic Scholar, or manual review
wiki/gaps.md for open questions, limitations, weakly supported claims, and future-work leads aggregated from paper/source/topic pages
wiki/context.md for a compact reading brief summarizing paper count, key concepts, active gaps, and recent changes
Do not make these optional artifacts first-run requirements. They are scale tools for research wikis that have enough papers to benefit from them.
3. Query mode
Use when the user asks questions against the local wiki.
Your job:
read the index first
follow the most relevant local pages
answer with citations to wiki pages and raw sources where appropriate
file high-value analyses back into the wiki when they would be useful later
4. Lint / maintain mode
Use when the wiki already exists and needs health checks.
Your job:
detect stale pages, orphan pages, broken links, duplicate topics, inconsistent naming, weak summaries, and unresolved ingestion leftovers
make targeted fixes
leave a short maintenance report with what changed and what still needs human review
5. Bridge / promote mode
Use when local knowledge has become useful beyond this project, or when the user asks how this project relates to another wiki, repo, domain, or global knowledge base.
Your job:
keep the local wiki authoritative for project-specific facts
identify only the durable concepts, patterns, decisions, comparisons, or entities worth promoting
create a local export packet under wiki/bridges/ rather than silently writing into an external/global vault
preserve provenance back to local pages and raw/source notes
recommend the destination and merge shape for a global wiki, but do not cross the locality boundary unless the user explicitly authorizes it
Default Folder Contract
If no wiki exists, bootstrap this minimal structure inside the current working directory:
raw/ # immutable source material dropped in by the user
wiki/
index.md # content-oriented catalog of the wiki
home.md # start-here overview for humans and agents
topics/ # concept/topic pages
entities/ # companies, tools, people, systems, components when relevant
sources/ # per-source summaries or source notes
bridges/ # optional export/promote packets for cross-project/global synthesis
schema/
wiki-rules.md # local conventions for this wiki
log/
log.md # append-only ingest/query/lint history
This is the default, not a law. If the repo already has a better local structure, adapt to it instead of forcing this exact layout.
If the domain is simpler, reduce it. For small tasks, wiki/index.md, wiki/home.md, wiki/topics/, and raw/ may be enough.
Do not create every folder just because it appears in this example. Create entities/, sources/, bridges/, or log/ only when they serve the actual project.
Optional category palette (evidence-gated)
Beyond topics/ and entities/, a richer business-/team-oriented palette is available when real material justifies it. Treat these as an opt-in palette, not auto-created scaffolding. init / bootstrap must not create them up front; add a folder only when sources, decisions, or repeated queries prove it earns its place, and record the choice in schema/wiki-rules.md.
wiki/
decisions/ # decisions + rationale + decision-maker (owner) + date
errors/ # failed approaches and risks that must not be retried
projects/ # per-project working context and deliverables
design/ # design principles, IA, screen/design guides
dev-tasks/ # development task units, dependencies, implementation notes
conversations/ # session handoff notes so a fresh agent can resume (see `save`)
These categories are an evidence-gated extension only when justified; the minimal-first default still governs first-run bootstrap.
Optional umbrella-domain / clustered wiki pattern
For one large but coherent domain inside the current working directory, a flat wiki/topics/ layer may eventually become hard to navigate. In that case, you may add an umbrella-domain structure with cluster mini-wikis, but only when source material, existing pages, or repeated user queries prove that stable sub-domains exist.
This is an advanced optional pattern, not the default. Keep novice onboarding simple and start flat unless the user explicitly asks for a large-domain structure or the inspected material clearly justifies clusters.
Stay with the flat default when:
the wiki has one main audience and one maintenance cadence
wiki/home.md, wiki/index.md, and wiki/topics/ are still easy to navigate
sources do not repeatedly belong to stable sub-domains
shared glossary or comparison pages are enough
cluster folders would mostly mirror speculative categories
Use umbrella clusters when:
the working directory intentionally covers one large coherent domain, such as Gas Hydrates, LLM Agents, or Process Simulation
at least two stable sub-domains recur across sources, topics, or queries
each sub-domain has enough material to justify a cluster home page or repeated local pages
readers need both an umbrella map and cluster-specific reading paths
cross-cluster concepts can stay local in wiki/shared/ without becoming a global vault
the clusters share the same local boundary, ownership, audience, and maintenance loop
Split into a separate project wiki or ask before reorganizing when:
a cluster has independent ownership, lifecycle, audience, confidentiality boundary, source stream, or maintenance cadence
keeping it inside the umbrella wiki would create noise, privacy risk, or misleading provenance
the cluster needs its own raw inputs, schema rules, log, bridge policy, or working-directory boundary
the user explicitly asks for a separate wiki
Optional clustered shape:
raw/
wiki/
home.md # umbrella start page
index.md # umbrella catalog and cluster map
topics/ # umbrella-level topics only when cross-cluster or domain-wide
entities/ # optional umbrella-level entities/systems/tools
sources/ # optional source notes that are domain-wide or not cluster-specific
shared/ # glossary, canonical concepts, shared comparisons, shared decisions
clusters/
<cluster>/
home.md # cluster start page and reading path
topics/ # cluster-local topic pages, only if justified
sources/ # cluster-local source notes, only if provenance benefits
comparisons/ # cluster-local comparisons, only if repeatedly useful
bridges/ # local promotion/export packets; external writes still require approval
schema/
wiki-rules.md
log/
log.md
wiki/shared/ is not a misc/ folder. Use it only for concepts that genuinely cross clusters: glossary terms, canonical definitions, shared decision records, reusable comparisons, or domain-wide relationship notes.
Graph or relationship maps may analyze umbrella and cluster links after the wiki has enough maintained pages, but graph tooling remains optional. Keep graph outputs inside the current working directory unless the user explicitly approves an external destination.
Optional research graph / citation layer
For scientific-paper wikis, a lightweight local graph can be useful once multiple papers and topics exist. Keep it file-based and optional:
wiki/
graph/
edges.jsonl # semantic relationships between local pages
citations.jsonl # bibliographic citation edges and metadata provenance
gaps.md # optional aggregated open questions / research gaps
context.md # optional compact query brief
.ingest-manifest.json # optional resumable batch ingest manifest
Rules:
Semantic edges and citation edges are different. A paper may cite another paper without supporting it, and a paper may semantically contradict another even if it does not cite it.
Each graph JSON line should include enough provenance to audit it: from, to, type, evidence, confidence, and source when known.
Relationship files are local wiki artifacts, not an external graph database. External graph export requires explicit approval.
If graph files become stale, maintenance should either rebuild them from wiki pages or mark them stale; do not silently trust old relationship data.
MECE Structuring Heuristic
When bootstrapping or reorganizing, aim for mutually exclusive, collectively exhaustive enough categories — but only to the scale justified by the project.
Good:
topics/ for ideas, mechanisms, workflows
entities/ for named actors or systems
sources/ for source-level summaries and provenance
Bad:
misc/
random-notes/
things/
20 top-level folders created before the directory is understood
If two folders are hard to distinguish, merge them.
Schema, Metadata, and Taxonomy Discipline
Keep metadata lightweight, but make long-lived pages inspectable. For any durable topic/entity/source/bridge page, include a small grounding block near the top when useful:
Type: topic | entity | source | decision | comparison | bridge
Status: draft | active | stale | candidate | exported | rejected
Built from: README.md, raw/source.md, [[sources/source-note]]
Last reviewed: YYYY-MM-DD
Confidence: high | medium | low
For pages that benefit from machine-readable headers (and for parity with portable wiki templates), the same grounding may instead be written as YAML frontmatter at the very top of the page:
Use either the grounding block or the YAML frontmatter consistently within a wiki; record which one in schema/wiki-rules.md.
Rules:
Do not force metadata onto tiny scratch pages, but add it to pages expected to survive across sessions.
If the local wiki uses tags, define the allowed vocabulary in schema/wiki-rules.md before spreading it across pages.
New page types or status labels must be recorded in schema/wiki-rules.md; do not let each page invent its own taxonomy.
Contradictions should be surfaced where a reader will see them: source note caveats are not enough if a topic page repeats the contested claim.
If source hashes, timestamps, or file mtimes are available, record enough drift signal to notice later changes. Do not silently normalize changed sources.
Global taxonomy can inspire the local schema, but must not distort the project-local structure. If global alignment is desired, use a bridge packet.
Non-Negotiable Conventions
1. Raw is immutable
raw/ is source material. Read from it. Do not rewrite it unless the user explicitly asks.
2. Wiki is generated and maintained
wiki/ is the maintained knowledge artifact. This is where synthesized understanding lives.
3. Provenance is preserved
Every important claim, summary, or extracted insight should point back to a raw source note, source file, or URL when practical.
Each created topic/entity page should also declare its grounding inputs near the top, for example:
Built from: README.md, raw/interview-2026-04-06.md, src/api/
4. Incremental updates beat rewrites
When a new source arrives, update the relevant pages and log the change. Do not regenerate the entire wiki unless the structure is badly broken.
Repeated ingestion should be idempotent:
one stable source note per source or source bundle
update existing pages when the same source is re-processed
do not create duplicate topic pages just because wording changed slightly
5. The wiki stays local
Do not silently widen scope from the current project to a personal knowledge base.
6. Navigation must stay legible
Every page should have an obvious path in and out: from home.md, index.md, a topic page, or a source note.
7. Local-to-global promotion is explicit
Project-local pages may mention global relevance, but they must not silently reorganize or write into a personal/global wiki. When knowledge should travel, create a bridge packet that summarizes the promotion candidate, evidence, target destination, and merge risks. The user decides whether to apply it outside the current directory.
Save Filters
Indiscriminate saving pollutes the wiki. Before persisting anything durable (the save action, or filing a query result back into wiki/), require that at least one of these five filters is true:
Reusable — will this information be reused in future work?
Handoff — must another agent or teammate read it to continue the project (continuity)?
Decision — is there a decision whose rationale and decision-maker (owner) need to be traceable later?
Failure-risk — is this a failed approach or risk that must not be retried?
Shared rule — is this a team-wide rule, convention, or design guide everyone must align on?
If none of the five hold, it is a one-off answer, impression, or trivial rewording — do not save it. When you decline to save, briefly state why.
This filter is what keeps a compounding wiki from degrading into a noisy dump.
Session Handoff (save)
The save action persists durable working context so a fresh agent or a teammate can resume cleanly. When something passes the save-filters:
route the durable knowledge to the right page (topic / decision / error / etc.) with provenance and standard frontmatter
write or update a session handoff note under wiki/conversations/ capturing: what was done, the key decisions, what is still unresolved, and which pages the next agent should read first
update wiki/index.md for any new persistent page and append a record to log/log.md
save is realistic, not magic: it persists what is judged durable under the filters, not a verbatim dump of the whole session.
Page Types
wiki/home.md
The start page for a human or agent entering the wiki cold.
Should include:
what this wiki is about
what the current focus is
where to start reading
the most important linked pages
wiki/index.md
The catalog. Organize pages by section with one-line descriptions.
wiki/sources/*.md
One page per important source or source bundle.
Should capture:
source identity
short summary
what changed in the wiki because of it
open questions or contradictions
For scientific papers, source notes should also capture paper metadata, key claims, methods, evidence anchors, citation context, limitations, and re-ingest drift. Use a dedicated paper source-note template when available.
wiki/topics/*.md
Persistent concepts, workflows, comparisons, decisions, or thematic summaries.
Create a new topic page only if at least one of these is true:
the concept appears across multiple sources or repo landmarks
the concept is important enough to be linked from more than one page
the material would make an existing page overloaded or incoherent
Otherwise, extend an existing page instead of creating a new one.
wiki/entities/*.md
Named systems, tools, people, teams, products, services, code components, or organizations when entity pages are actually useful.
Do not create entity pages just because the folder exists.
Entity pages should be rare in small repos. If the entity is mentioned only once or adds no navigation value, keep it inside a topic or source page.
wiki/bridges/*.md
Promotion or export packets for knowledge that may belong in another project wiki, a global llm-wiki, or a higher-level concept map.
Bridge pages are not a second wiki. They are handoff artifacts. Include:
local source pages and topic pages that justify the export
the distilled claim, pattern, decision, or comparison worth promoting
proposed destination page(s) or target domain
conflicts, confidence level, and merge risks
clear status: candidate, approved-to-export, exported, or rejected
Create schema/wiki-rules.md describing the local contract.
Create wiki/home.md and wiki/index.md.
Create only a few grounded pages tied to the actual directory contents.
Log the bootstrap in log/log.md.
Before creating any page, ask:
What exact files, folders, notes, or sources justify this page?
Would updating an existing page be better than creating a new one?
Will this page improve navigation, or is it just tidy-looking scaffolding?
Bootstrap should feel like laying down navigational rails, not building a cathedral.
Ingest Workflow
When new material appears in raw/:
Read the new source.
Decide what kind of source it is: article, paper, transcript, meeting notes, product doc, export, mixed scratch notes, etc.
Create or update a source page in wiki/sources/.
Update related topic/entity pages with the durable knowledge from that source.
Mark uncertainty where the source is ambiguous, partial, or contradictory.
Update wiki/index.md if a new persistent page was added.
Append an ingest record to log/log.md.
If one source touches many pages, that is normal.
Do not treat provenance as a decorative backlink. Major sections should make it clear which source note or raw input they came from.
Scientific paper ingest workflow
When the new source is a paper PDF, TeX bundle, paper Markdown, bibliography, or supplement:
Classify the source bundle: PDF, TeX entry file, included TeX sections, figures, tables, bibliography, supplements, converted Markdown, or metadata-only citation export.
Extract safely:
For PDFs, prefer a clean Markdown conversion path such as MarkItDown or a paper-conversion skill/tool when available.
For TeX, read the entry file and included section files directly when possible; preserve equations, labels, captions, and bibliography keys as evidence anchors.
If extraction is incomplete, continue with visible uncertainty instead of fabricating missing content.
Create or update one stable paper source note in wiki/sources/ for the paper or source bundle. Do not create duplicate notes for corrected PDFs, revised TeX exports, or updated .bib files.
Capture paper metadata: title, authors, venue/year, DOI/arXiv ID, source path(s), conversion path, bibliography path, date ingested, confidence, and source drift signal when available.
Extract the research map where accessible: problem, key idea, method, assumptions, datasets, experiments, results, limitations, open questions, important equations, figures/tables, and references. Mark items that could not be extracted as uncertain or missing.
Deduplicate before page creation: search existing wiki index/source/topic pages for similar concepts, methods, claims, datasets, and acronyms. Merge into existing pages unless a new page clearly improves navigation.
Apply an importance budget: record paper importance or relevance. Low-importance papers should mostly update the source note and existing topics; high-importance papers may create a small number of new topic/shared pages.
Update durable pages: add only reusable concepts, methods, claims, datasets, limitations, comparisons, and open questions to topic/shared pages with backlinks to the paper source note.
Optionally update local relationship artifacts: append semantic edges, citation edges, a gap-map entry, context brief notes, or an ingest manifest entry if the local wiki already uses those artifacts.
Log the ingest in log/log.md with source identity, pages created/updated, conversion caveats, and review-needed items.
Query Workflow
When the user asks a question that should compound into the wiki:
Read wiki/index.md first.
Follow the relevant topic/entity/source pages.
Check whether the maintained wiki is actually sufficient for the question.
If it is not sufficient, read the missing raw/source material, update the wiki first, then answer.
If the answer creates a valuable new artifact — comparison, synthesis, decision memo, glossary, taxonomy, timeline — file it back into wiki/.
Log the query if it materially changed the wiki.
High-value answers should not disappear into chat history if they would clearly help later.
Bridge / Promotion Workflow
Use this when the project-local wiki has knowledge that should inform another repo, a global llm-wiki, an external vault, or a cross-project synthesis.
Prove local grounding first: read wiki/index.md, relevant topic/entity/source pages, and raw evidence anchors if needed.
Classify the candidate:
concept: reusable idea, pattern, method, or failure mode
decision: architecture or process choice that may guide other projects
comparison: reusable side-by-side evaluation
entity: named tool/system/org/person worth tracking globally
anti-pattern: failure mode that should become a future warning
Create a bridge packet in wiki/bridges/<slug>.md only when at least one is true:
the idea appears in multiple local pages or sources
the user explicitly asks for cross-project/global synthesis
the knowledge would prevent future rework in another project
the pattern is portable beyond this repo's file structure
Do not write outside the current directory by default. The bridge packet is the safe artifact. External/global updates require explicit user approval and a destination path.
Record merge instructions: proposed global page title, tags/taxonomy suggestions, outbound links, and what must remain local-only.
Log the bridge action in log/log.md.
Bridge packet template
# Bridge: <candidate title>
Status: candidate
Type: concept | decision | comparison | entity | anti-pattern
Proposed destination: <destination-wiki>/<page-or-slug>.md or <unknown>
Confidence: high | medium | low
## Local grounding
- Built from: [[topics/...]], [[sources/...]], raw/...
## Portable knowledge
- What should travel beyond this local wiki?
## What must stay local
- Repo-specific paths, transient implementation notes, or context that should not pollute the global wiki.
## Merge risks / contradictions
- Existing global pages that may conflict
- Claims needing human review
## Suggested global links/tags
- Related global pages or likely tags
Maintenance Workflow
Periodically check for:
broken or stale links
orphan pages with no inbound path
duplicate or near-duplicate topics
weak openings that do not tell the reader what the page is for
source notes that were never integrated into topic pages
pages that became obsolete after newer sources arrived
index drift, where index.md no longer reflects reality
bridge drift, where wiki/bridges/ candidates were exported or rejected but not marked
tag/schema drift, where pages invent incompatible labels or page types
contradiction drift, where conflicting claims are noted in source pages but not surfaced in topic pages
source drift, where raw/source files changed since the source note was created when hashes or timestamps are available
Fix what is clearly safe. Flag what needs human judgment.
Always leave a concise maintenance report.
Lightweight health gates
When maintaining a wiki, check these before claiming success:
Gate
Pass condition
Boundary
No page silently widens scope beyond the current directory
Navigation
Important pages are reachable from wiki/home.md or wiki/index.md
Provenance
Durable claims point to source notes, raw files, or repo landmarks
Paper ingest
Paper metadata, claims, methods, citations, figures/tables, limitations, and open questions are traceable to source notes or raw files
Promotion
Cross-project claims are represented as bridge packets, not hidden external edits
Cluster boundaries
Clustered wiki sections, if present, are evidence-driven and still inside the current working directory
Shared pages
wiki/shared/ contains cross-cluster concepts, not a catch-all misc dump
Contradictions
Conflicting claims are explicitly marked and routed to human review when unsafe
Drift
Source/hash/timestamp changes are flagged instead of silently normalized
Provenance Pattern
Use lightweight provenance. Do not turn every sentence into citation soup.
Good enough patterns include:
Source: [[sources/article-name]]
Derived from: raw/interview-2026-04-06.md
Evidence: [[sources/vendor-api-notes]]
Uncertain: this claim appears in one partial transcript only
When sources conflict, say so explicitly.
At minimum, each durable page should let a future reader answer:
which sources or repo landmarks shaped this page?
where should I go to verify the main claims?
Minimal log/log.md Format
Use parseable headings so recent activity is easy to scan.
## [2026-04-06] bootstrap | initialized local wiki
- Created wiki/home.md, wiki/index.md, schema/wiki-rules.md
- Seeded topic pages for project structure and workflow
## [2026-04-06] ingest | vendor-api-export
- Added source page: wiki/sources/vendor-api-export.md
- Updated topics/integration-pitfalls.md
Keep it append-only.
schema/wiki-rules.md Must Capture
When bootstrapping, document the local rules for future sessions:
the scope boundary of the wiki
the exact locality boundary (current folder, subproject, or full repo)
what belongs in raw/ vs wiki/
page naming conventions
whether wiki links or normal markdown links are preferred
provenance style
when a new page is allowed versus when an existing page must be updated
how repeated ingest updates existing pages without duplication
how maintenance reports should be recorded
whether bridge packets are allowed, where they live, and what approval is required before external export
whether umbrella-domain clusters are allowed, what justifies a cluster, and when a cluster should split into a separate wiki
what may live in wiki/shared/, if that folder exists
whether scientific-paper mode is used, which paper metadata fields are required, and whether local graph/citation/gap/context artifacts are enabled
the local tag/type vocabulary if the wiki needs one; keep it small and document new labels before using them widely
how contradictions, confidence, and source drift should be represented
This is what turns a generic markdown pile into a disciplined maintained wiki.
Anti-Patterns
Do not do these:
create a giant universal vault when the user asked about one project
dump all ingested knowledge into one long summary page
duplicate existing README content without adding navigation value
invent folders and pages with no grounding in the actual directory
create scaffolding that mirrors folder names or README headings without adding synthesis
rewrite raw/ as if it were polished wiki content
treat a scientific paper as a giant standalone summary with no metadata, methods, evidence anchors, citation context, or topic integration
create a new topic page for every paper section, figure, acronym, or citation without deduplication and navigation value
erase uncertainty from partial or conflicting sources
merge pages aggressively when overlap might reflect different purposes
add indexes everywhere; add them only where navigation actually benefits
silently write into a global wiki because a local pattern seems broadly useful
refuse all cross-project synthesis because the wiki is local; create a bridge packet instead
let every project invent incompatible bridge/status/confidence labels without recording the local convention
Good Output Standard
After using this skill, the working directory should feel like this:
a future agent can open wiki/home.md and orient quickly
the wiki structure is small, local, and legible
new sources can be added without redesigning everything
important claims can be traced back to source notes or raw material
the wiki gets richer over time instead of noisier
cross-project/global relevance is captured as explicit bridge packets rather than leaking across boundaries
That is the point of llm-wikify: persistent, compounding project knowledge without the cost of maintaining a giant all-purpose knowledge base.
