Lw Reflect

LLM Wiki Reflect

Reflect on the wiki to make it smarter over time using a two-stage process: cheap discovery first, targeted deep reading second.

wiki/ is canonical. outputs/ is non-canonical artifact storage that may contain promotion candidates.

Required reads

1. .llm-wiki/reflect_state.json
2. .llm-wiki/manifest.json
3. .llm-wiki/profile.json
4. Active profile markdown
5. wiki/index.md
6. wiki/log.md

If wiki/index.md is missing, stop and ask the user to initialize or repair the workspace first.

Step-by-step procedure

1. Load reflect state

Read .llm-wiki/reflect_state.json. Extract:

• last_reflected_at
• synthesized_articles

If the file is missing or empty, treat last_reflected_at as null and synthesized_articles as an empty list.

2. Identify recently changed wiki pages

Read .llm-wiki/manifest.json. Collect manifest entries where:

• compiled_at is newer than last_reflected_at, or
• last_reflected_at is null

Extract their wiki_articles as recently changed pages. Prioritize these during reflection.

3. Stage 1 — discovery from index first

Read wiki/index.md. Using only the index and profile priorities, identify the 3–5 strongest candidates for:

• synthesis
• contradiction notes
• relationship pages
• gap pages
• new comparison or query pages
• promotion of durable knowledge currently stranded in outputs/

Prioritize candidates that involve recently changed pages. Skip candidates that clearly duplicate already-synthesized pages recorded in reflect state.

For each candidate, record:

• type
• hypothesis
• pages_to_read
• proposed_slug
• proposed_title

If nothing is strong enough, return a short summary and stop without writing low-value pages.

4. Audit outputs/ for promotion candidates

If outputs/ exists, inspect markdown/text artifacts that may contain durable knowledge.

Look for outputs that are:

• grounded in existing wiki pages
• substantial enough to help future queries
• not yet represented canonically in wiki/

Classify each reviewed artifact as:

• keep as non-canonical output
• promote into wiki/
• stale/redundant output

For promotion candidates, add them to the candidate list with:

• type: output-promotion
• source output path
• proposed canonical destination under wiki/

5. Stage 2 — targeted deep read

For each candidate, read only the pages needed to validate the hypothesis. Read neighboring pages only when they are directly relevant. Avoid loading the whole wiki unnecessarily.

For output-promotion candidates, read:

• the output artifact itself
• the most relevant canonical wiki pages
• nearby pages needed to avoid duplication or contradiction

6. Evaluate synthesis quality

Before writing anything, classify the evidence:

• strong → create or update a page
• weak → log as found-but-not-written in the report

Rules:

• do not create pages from weak evidence
• prefer updating existing high-value pages over creating too many new ones
• respect profile-specific priorities for what kinds of synthesis matter most
• when promoting from outputs/, rewrite into canonical wiki form instead of merely copying the artifact wholesale

7. Write or update high-value pages

For strong candidates:

• create or update the appropriate page under wiki/
• add backlinks or related links when appropriate
• keep contradiction handling explicit
• follow wiki/SCHEMA.md if present

For promoted outputs:

• convert the durable knowledge into the right canonical destination such as wiki/queries/, wiki/comparisons/, or another schema-approved page type
• do not make future query behavior depend on the output artifact
• optionally note in the report that the output has been superseded by canonical wiki content

8. Write a reflection report

Write outputs/YYYY-MM-DD-lw-reflect-report.md. Include:

• pages created or updated
• candidates found but not written
• outputs reviewed for promotion and their classification
• suggested next ingestion or maintenance actions

9. Update index, log, and reflect state

• update wiki/index.md for any new canonical pages and for the reflection report only if the workspace tracks outputs there
• append a reflection entry to wiki/log.md
• update .llm-wiki/reflect_state.json with:
  • new last_reflected_at
  • cumulative synthesized_articles

10. Print terminal summary

Return:

• candidates reviewed
• pages created or updated
• weak candidates skipped
• outputs promoted or left non-canonical
• follow-up ingestion or lint suggestions
• reflection report path

Hard rules

• prefer index-first discovery over brute-force reading
• do not create pages from weak evidence
• prioritize recently changed areas when reflect state supports it
• keep reflection outputs durable and stateful
• use reflection as the normal place to promote durable knowledge from outputs/ into canonical wiki pages