bruce48x/Lakona / .agents/skills/lakona-doc-maintenance
lakona-doc-maintenance
VerifiedAudit Lakona contributor documentation and report findings, or apply authorized cleanup to stale plans, duplicate authorities, and documentation maps within the requested scope.
Lakona Doc Maintenance
Keep the contributor path focused on current rules and architecture. During authorized cleanup, preserve useful present-day contracts and delete obsolete material instead of archiving it.
Mode And Authorization
- Audit: inspect and report findings, evidence, and proposed dispositions. Do not edit or delete project files, move contracts, update maps, or advance versions. An audit or review request alone does not authorize cleanup.
- Cleanup: an explicit cleanup request or request to fix identified findings authorizes changes within that scope. Reuse existing authorization; do not ask again for routine edits it covers. Unselected findings remain proposals.
Honor instructions to report first and wait for confirmation. If only an audit is requested, finish with its report; do not continue into cleanup automatically.
Scope And Reading
Follow CONTRIBUTING.md and reuse applicable instructions already read.
docs/** contains durable maintainer documentation. User-facing content,
including root and package README files, is outside cleanup scope unless
requested, except for link repairs needed by the authorized cleanup. Repair
those links and any directly associated link labels without expanding into a
user-facing content rewrite.
| Work | Reference to read |
|---|---|
| Classify a document, merge duplicates, or decide what to remove | classification.md |
| Assess documentation quality | audit-checklist.md |
| Run a full audit's inventory, searches, and link verification | operations.md |
A full audit completes six independent passes: factual consistency, ownership, stale plans, duplication, competing authorities, and transitional wording. Read the complete audit checklist for that mode. For reduced scope, read and run each affected pass; justify any not-applicable decision with evidence. The full operations reference is not required reading for a small scoped correction.
Work And Completion
- Identify the requested documents and their incoming references. Use
rgto discover maintained files, references, and relevant headings. - Apply the relevant classification and audit guidance. Check factual claims against implementation, tests, configuration, or generated output.
- For audit mode, report evidence, findings, proposed dispositions and coverage limitations. Give clear/findings/not-applicable results for each required pass, then stop without applying the proposals. Full audits also complete the operations reference's audit verification.
- For authorized cleanup only, check incoming links before deleting. Move any
durable rule into its current authority and update affected links and the
CONTRIBUTING.mdmap. - Edit within scope. Repeat affected checks after edits; leave no conflicting authority, broken incoming reference, or duplicate mutable fact caused by the cleanup. Remove temporary planning docs created during the cleanup.
- Report the applied changes, evidence and results for affected passes.
Scoped corrections verify affected links and
git diff --check.
Follow the repository's validation stopping rules. Do not present a partial audit as complete or infer correctness merely from repeated documentation.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |