Skip to content

Commit 715d775

Browse files
authored
feat(wiki): add continuous learning curation governance
Adds V0.11.0 continuous wiki curation governance, wiki-curator skill, taxonomy, metrics, schema/catalog updates, and release records.
1 parent fdab188 commit 715d775

24 files changed

Lines changed: 819 additions & 65 deletions

AGENTS.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ Load only the documents relevant to the session context. This `AGENTS.md` file i
3939
| Skill / agent self-improvement | `AGENTS.md`, `FCVW/AI.md`, `FCVW/PLANNING.md`, `FCVW/AUDIT.md`, `FCVW/skills/self-improvement/SKILL.md` |
4040
| Release | `AGENTS.md`, `FCVW/skills/release-checklist/SKILL.md`, `FCVW/VERSIONING.md` (on demand) |
4141
| Security / data | `AGENTS.md`, `FCVW/SECURITY.md`, `FCVW/DATA.md`, `FCVW/ENVIRONMENT.md` |
42-
| AI / RAG / wiki | `AGENTS.md`, `FCVW/AI.md`, `FCVW/wiki/schema.md` |
42+
| AI / RAG / wiki | `AGENTS.md`, `FCVW/AI.md`, `FCVW/wiki/schema.md`, `FCVW/skills/wiki-curator/SKILL.md` (for curation tasks) |
4343
| Document audit | `AGENTS.md`, `FCVW/MANIFEST.md`, `FCVW/AUDIT.md` |
4444
| Starting a new project | `AGENTS.md`, `FCVW/INSTANTIATION.md`, `FCVW/BRIEFING.md`, `FCVW/MANIFEST.md` |
4545
| Retroactive instantiation / migration | `AGENTS.md`, `FCVW/RETROACTIVE_INSTANTIATION.md`, `FCVW/INSTANTIATION.md`, `FCVW/CONTEXT_MAP.md` |
@@ -97,6 +97,7 @@ Detailed rules are in the domain documents. Summary of responsibility:
9797
- **Anti-monolith and code hygiene**: before creating or extending large modules, components, routes, services, prompts, or catch-all utility files, load `FCVW/skills/anti-monolith-guard/SKILL.md`. When duplication, stale files, dead code, repeated snippets, or retroactive cleanup are involved, load `FCVW/skills/code-hygiene-refactor/SKILL.md`. If a gate fails, split the plan before editing.
9898
- **Agent/skill factory**: do not create new skills, agent profiles, specialist personas, or command packs by convenience. Load `FCVW/skills/agent-factory/SKILL.md`, prove recurrence, coverage gap, token/risk ROI, narrow scope, and validation before adding the asset.
9999
- **Skill/agent self-improvement**: do not adjust existing skills or agent profiles for style-only preferences. Load `FCVW/skills/self-improvement/SKILL.md` and record evidence, metric passed, scope preservation, and validation replay before editing any skill/profile.
100+
- **Wiki continuous learning**: when knowledge must be promoted, revised, grouped, tagged, linked, or scheduled for review, load `FCVW/skills/wiki-curator/SKILL.md`. Use the fixed optimized curation mode; do not expose customizable cost modes.
100101
- **Documentation**: plans go in `FCVW/Plans/{status}`; `AGENTS.md` must be updated when new official documents are created; templates in `FCVW/governance/` follow structural changes of the VibeWork FrameCode.
101102
- **Application module documentation**: when a change affects relevant pages, screens, modules, components, flows, or business rules in a downstream application, consult `FCVW/APPLICATION_DOCUMENTATION.md` and update the application-owned documentation path defined there.
102103
- **Agent journals**: agent-specific journals must live under `FCVW/wiki/agents/<agent_name>_journal.md`; do not create competing journal paths.
@@ -134,7 +135,7 @@ Before executing a request that might modify files:
134135
- for release, consult `FCVW/RELEASE.md`;
135136
- for security, consult `FCVW/SECURITY.md`;
136137
- for persistence, consult `FCVW/DATA.md`;
137-
- for AI, RAG, memory, or continuous learning, consult `FCVW/AI.md` and `FCVW/wiki/schema.md`;
138+
- for AI, RAG, memory, or continuous learning, consult `FCVW/AI.md`, `FCVW/wiki/schema.md`, and `FCVW/skills/wiki-curator/SKILL.md` when wiki curation, knowledge promotion, grouping, tagging, thematic colors, or review metrics are involved;
138139
- for refactoring, consult `FCVW/REFACTORING.md`;
139140
- for architectural decisions, consult `FCVW/ARCHITECTURAL_DECISIONS.md`;
140141
- for auditing or release closure, consult `FCVW/AUDIT.md`;

FCVW/AI.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -66,6 +66,11 @@ Rules:
6666
- avoid overwriting knowledge without backup;
6767
- mark AI-generated content when applicable;
6868
- allow human review when the content is critical.
69+
- use `skills/wiki-curator/SKILL.md` when knowledge must be promoted, revised, grouped, deduplicated, tagged, or scheduled for review;
70+
- prefer updating or superseding an existing wiki page before creating a new one;
71+
- track freshness, promotion precision, duplication, release synthesis coverage, taxonomy coverage, and cost control using `wiki/metrics.md`;
72+
- organize curated wiki pages with canonical tags, `theme`, and `theme_color` from `wiki/taxonomy.md`;
73+
- use one fixed optimized curation mode only: JIT loading of index/log/schema/taxonomy/metrics plus directly triggered source records. Do not expose customizable curation cost modes.
6974

7075
### Agent with Tools
7176

@@ -159,6 +164,7 @@ Rules:
159164
- Learning generated from a conversation must be traceable.
160165
- Agent-specific journals must use `wiki/agents/<agent_name>_journal.md`.
161166
- Agent journals are append-only operational memory for durable project-specific learnings, not routine chat transcripts.
167+
- Reusable journal learnings must be promoted or linked through `wiki-curator` instead of remaining isolated in chronological notes.
162168

163169
## AI Interaction Context Compression (AICC)
164170

@@ -192,6 +198,7 @@ To deliver highly-specialized command sets and instruction procedures without in
192198
- **Handoff Tracking:** Every skill file loaded during a session must be formally recorded under the `skills_invoked` section in the AICC Session Synthesis `S*.md` file.
193199
- **Controlled Extension:** New skills and agent profiles are allowed only through `skills/agent-factory/SKILL.md`; convenience, naming, or persona-only additions are invalid.
194200
- **Evidence-Based Self-Improvement:** Existing skills and agent profiles can be changed only through `skills/self-improvement/SKILL.md` when evidence proves failure, drift, validation gap, or meaningful token/risk reduction.
201+
- **Wiki Curation:** `skills/wiki-curator/SKILL.md` owns continuous wiki learning tasks. Use it after releases, recurring troubleshooting, grouped notes, or explicit wiki-maintenance requests.
195202

196203
### 2. Agent and Skill Creation Metrics
197204

@@ -293,6 +300,7 @@ To optimize execution speed, minimize financial API token costs, and prevent con
293300
### 2. Context Boundaries & Pruning
294301
* **Strict Domain Isolation:** Never open, read, or search files that are outside the active session type mapped in the table in `AGENTS.md` (e.g., in a bugfix session, do not open `DESIGN.md` or `DATA.md`).
295302
* **Chunked View Limits:** Do not view entire large files. Limit reads using targeted line range parameters (`StartLine` and `EndLine`) to inspect only the required context.
303+
* **Fixed Wiki Curation Mode:** When curating wiki knowledge, use the standard optimized mode in `skills/wiki-curator/SKILL.md`. Load only routing documents, wiki index/log/schema/taxonomy/metrics, and directly triggered source records unless `wiki-lint` finds an anomaly.
296304

297305
### 3. Log and Terminal Compaction
298306
* **Silent Execution Flags:** When executing terminal commands, always use the shortest possible status flags (e.g., `git status -s` instead of `git status`) and suppress verbose outputs.
@@ -325,6 +333,8 @@ To facilitate retrieval and visualization in Obsidian, the AI must use the follo
325333
- `#refactor-plan`: Plans and results of refactorings.
326334
- `#user-feedback`: Insights and direct requests from the user.
327335

336+
Canonical themes, thematic colors, optional frontmatter fields, and extended tag guidance live in `wiki/taxonomy.md`. Freshness and curation metrics live in `wiki/metrics.md`.
337+
328338
## Models and Templates
329339

330340
To create new AI feature specifications, use the template in:

FCVW/AUDIT.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -32,6 +32,7 @@ Items:
3232
- anti-monolith and code hygiene gates present when plans create or expand non-trivial modules;
3333
- agent/skill creation gates present when plans add new skills, agent profiles, specialist roles, or reusable operational procedures;
3434
- self-improvement gates present when plans modify skills, agent profiles, triggers, or agent operating rules;
35+
- wiki-curation evidence present when plans promote, revise, group, retag, or schedule wiki knowledge;
3536
- no plan closes with unresolved duplication, stale files, or dead-code cleanup claims without evidence or deferral;
3637
- absence of contradictory instructions;
3738
- updated templates.
@@ -112,6 +113,7 @@ Items:
112113
- retrieved context;
113114
- boundaries of action;
114115
- memory and learning;
116+
- wiki curation cost mode, taxonomy, freshness metrics, and source coverage;
115117
- sensitive data;
116118
- conflicting instructions.
117119

@@ -134,6 +136,7 @@ Items:
134136
- [ ] Plans that created skills, agent profiles, command packs, or reusable operational procedures recorded recurrence, coverage gap, token/risk ROI, scope boundary, and validation task.
135137
- [ ] Plans that changed skills, agent profiles, triggers, or agent operating rules recorded failure/drift evidence, metric passed, scope preservation, token/risk ROI, and validation replay.
136138
- [ ] `skills/README.md`, `CONTEXT_MAP.md`, and `STACK.md` list every active skill/profile exactly once.
139+
- [ ] Wiki curation changes use `skills/wiki-curator/SKILL.md`, `wiki/taxonomy.md`, and `wiki/metrics.md` when tags, themes, grouping, freshness, or promotion are affected.
137140
- [ ] No new agent or skill is persona-only, style-only, broader than its trigger family, or overlapping another asset by more than 50%.
138141
- [ ] `R4` and `R5` plans include rollback and expanded validation, and `R5` plans record explicit human approval.
139142
- [ ] High-risk low-priority plans were postponed, decomposed, discontinued, or explicitly justified.
@@ -147,7 +150,7 @@ Items:
147150
- [ ] `SECURITY.md` reflects security changes.
148151
- [ ] `AI.md` reflects AI changes.
149152
- [ ] `TESTS.md` was used for validation compatible with risk.
150-
- [ ] The governance wiki was updated when the audit generated reusable learning.
153+
- [ ] The governance wiki was updated when the audit generated reusable learning, and `wiki/index.md` / `wiki/log.md` were synchronized.
151154
- [ ] There are no temporary files being used as official source.
152155

153156
## Quick Audit Checklist for AI Agents

FCVW/CONTEXT_MAP.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ This document is designed to be the **first auxiliary document consulted after `
2323
| **Release / Version / Changelog** | `AGENTS.md §checklist`, `skill:release-checklist` | `VERSIONING.md`, `AUDIT.md`, `RELEASE.md`, `skill:governance-validator` | `DESIGN.md`, `REFACTORING.md` |
2424
| **Briefing / Instantiation** | `AGENTS.md §checklist`, `INSTANTIATION.md`, `BRIEFING.md` | `skill:project-instantiation`, `MANIFEST.md`, `STACK.md` | `REFACTORING.md`, `RELEASE.md` |
2525
| **Retroactive Instantiation / Migration** | `AGENTS.md §checklist`, `RETROACTIVE_INSTANTIATION.md`, `INSTANTIATION.md` | `CONTEXT_MAP.md`, `skill:retroactive-instantiation`, `MANIFEST.md`, `STACK.md` | `DESIGN.md`, `REFACTORING.md`, `RELEASE.md` |
26-
| **Wiki / Knowledge** | `AGENTS.md §checklist`, `wiki/schema.md`, `wiki/index.md` | `skill:wiki-lint`, `wiki/log.md` | `DESIGN.md`, `DATA.md`, `SECURITY.md` |
26+
| **Wiki / Knowledge** | `AGENTS.md §checklist`, `wiki/schema.md`, `wiki/index.md` | `skill:wiki-curator`, `skill:wiki-lint`, `wiki/log.md`, `wiki/taxonomy.md`, `wiki/metrics.md` | `DESIGN.md`, `DATA.md`, `SECURITY.md` |
2727
| **Security / Data** | `AGENTS.md §checklist`, `SECURITY.md`, `DATA.md` | `AI.md`, `TESTS.md`, `skill:agent-aegis` | `DESIGN.md`, `REFACTORING.md` |
2828
| **Document Audit** | `AGENTS.md §checklist`, `MANIFEST.md`, `AUDIT.md` | `skill:governance-validator`, `skill:agnix-linter`, `wiki/index.md`, `changelogs/` | `DESIGN.md`, `DATA.md` |
2929
| **Pull Request / Code Review** | `AGENTS.md §Code Review and Pull Requests` | `FCVW/refactoring-guide/17-branch-and-pull-request-policy.md` (if refactoring PR), `PLANNING.md` (risk gates) | Most governance docs |
@@ -55,6 +55,7 @@ This document is designed to be the **first auxiliary document consulted after `
5555
| `skills/release-checklist/SKILL.md` | release, publish, version bump, changelog, publicar versão | ~2.7k tokens vs. RELEASE+VERSIONING+AUDIT |
5656
| `skills/self-improvement/SKILL.md` | improve skill, improve agent, skill failed, gatilho falhou | Evidence-based gate for modifying skills and agent profiles |
5757
| `skills/systematic-debugging/SKILL.md` | debugging, fixing an error, stack trace | Enforces hypothesis-based debugging |
58+
| `skills/wiki-curator/SKILL.md` | curate wiki, continuous learning, agrupar notas, frontmatter colors | Promotes and clusters wiki knowledge in fixed optimized mode |
5859
| `skills/wiki-lint/SKILL.md` | lint, wiki audit, orphan pages | ~275 lines vs. reading schema.md §12 |
5960

6061
---
@@ -68,7 +69,7 @@ This document is designed to be the **first auxiliary document consulted after `
6869

6970
---
7071

71-
## Document Size Reference (V0.10.3)
72+
## Document Size Reference (V0.11.0)
7273

7374
> Use to make informed decisions about what to load. Larger files cost more tokens.
7475
@@ -81,10 +82,11 @@ This document is designed to be the **first auxiliary document consulted after `
8182
| `skills/code-hygiene-refactor/SKILL.md` | ~4 KB | Use for cleanup/refactoring triage |
8283
| `skills/agent-factory/SKILL.md` | ~4 KB | Use for controlled skill/agent creation |
8384
| `skills/self-improvement/SKILL.md` | ~4 KB | Use for evidence-based skill/agent changes |
85+
| `skills/wiki-curator/SKILL.md` | ~4 KB | Use for wiki curation, clustering, taxonomy, and metrics |
8486
| `AI.md` | ~11 KB | On demand (AI sessions) |
8587
| `APPLICATION_DOCUMENTATION.md` | ~4 KB | On demand (application module docs) |
8688
| `FCVW/README.md` | ~13 KB | Rarely (framework orientation only) |
87-
| `wiki/schema.md` | ~9 KB | Use `skill:wiki-lint` instead |
89+
| `wiki/schema.md` | ~11 KB | Use `skill:wiki-lint` or `skill:wiki-curator` instead |
8890
| `SECURITY.md` | ~7 KB | On demand (security sessions) |
8991
| `ENVIRONMENT.md` | ~6 KB | On demand (environment sessions) |
9092
| `PERFORMANCE.md` | ~5 KB | On demand (performance sessions) |

FCVW/FILESYSTEM.md

Lines changed: 11 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ type: "concept"
44
status: "validated"
55
confidence: "high"
66
last_reviewed: "2026-06-17"
7-
related_version: "V0.10.3"
7+
related_version: "V0.11.0"
88
sources:
99
- "STACK.md"
1010
- "SCOPE.md"
@@ -42,6 +42,7 @@ In accordance with [ADR-0001](decisions/ADR-0001-pure-markdown-over-automation-s
4242
| | |-- V0.10.1.md
4343
| | |-- V0.10.2.md
4444
| | |-- V0.10.3.md
45+
| | |-- V0.11.0.md
4546
| | |-- V0.9.0.md
4647
| | \-- V0.9.1.md
4748
| |-- decisions/
@@ -83,6 +84,7 @@ In accordance with [ADR-0001](decisions/ADR-0001-pure-markdown-over-automation-s
8384
| | | |-- P1-R4-2026-06-11-service-research-mandate.md
8485
| | | |-- P2-R1-2026-06-17-v0103-github-release-publication.md
8586
| | | |-- P2-R2-2026-06-17-v0103-release-governance-jit-fixes.md
87+
| | | |-- P2-R2-2026-06-17-v0110-wiki-continuous-learning-governance.md
8688
| | | |-- P2-R3-2026-06-11-environment-promotion-workflow.md
8789
| | | |-- P2-R3-2026-06-11-pr-branch-workflow.md
8890
| | | |-- P2-R3-2026-06-13-anti-monolith-code-hygiene.md
@@ -161,6 +163,8 @@ In accordance with [ADR-0001](decisions/ADR-0001-pure-markdown-over-automation-s
161163
| | | \-- SKILL.md
162164
| | |-- systematic-debugging/
163165
| | | \-- SKILL.md
166+
| | |-- wiki-curator/
167+
| | | \-- SKILL.md
164168
| | |-- wiki-lint/
165169
| | | \-- SKILL.md
166170
| | \-- README.md
@@ -195,6 +199,7 @@ In accordance with [ADR-0001](decisions/ADR-0001-pure-markdown-over-automation-s
195199
| | | \-- README.md
196200
| | |-- releases/
197201
| | | |-- README.md
202+
| | | |-- v0-11-0-summary.md
198203
| | | \-- v0-8-0-summary.md
199204
| | |-- sessions/
200205
| | | |-- README.md
@@ -203,7 +208,8 @@ In accordance with [ADR-0001](decisions/ADR-0001-pure-markdown-over-automation-s
203208
| | | |-- S003-2026-06-13-agent-self-improvement-template-site.md
204209
| | | |-- S004-2026-06-13-v0101-cleanup-optimization.md
205210
| | | |-- S005-2026-06-14-final-compliance-qa.md
206-
| | | \-- S006-2026-06-17-v0103-release-governance-jit-fixes.md
211+
| | | |-- S006-2026-06-17-v0103-release-governance-jit-fixes.md
212+
| | | \-- S007-2026-06-17-v0110-wiki-continuous-learning-governance.md
207213
| | |-- sources/
208214
| | | \-- README.md
209215
| | |-- syntheses/
@@ -221,8 +227,10 @@ In accordance with [ADR-0001](decisions/ADR-0001-pure-markdown-over-automation-s
221227
| | | \-- TEMPLATE_TECH_DEBT.md
222228
| | |-- index.md
223229
| | |-- log.md
230+
| | |-- metrics.md
224231
| | |-- README.md
225-
| | \-- schema.md
232+
| | |-- schema.md
233+
| | \-- taxonomy.md
226234
| |-- AI.md
227235
| |-- APPLICATION_DOCUMENTATION.md
228236
| |-- ARCHITECTURAL_DECISIONS.md

0 commit comments

Comments
 (0)