Skip to content

bruce48x/Lakona / .agents/skills/lakona-doc-maintenance

lakona-doc-maintenance

Verified

Audit 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.

WorkReference to read
Classify a document, merge duplicates, or decide what to removeclassification.md
Assess documentation qualityaudit-checklist.md
Run a full audit's inventory, searches, and link verificationoperations.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

  1. Identify the requested documents and their incoming references. Use rg to discover maintained files, references, and relevant headings.
  2. Apply the relevant classification and audit guidance. Check factual claims against implementation, tests, configuration, or generated output.
  3. 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.
  4. For authorized cleanup only, check incoming links before deleting. Move any durable rule into its current authority and update affected links and the CONTRIBUTING.md map.
  5. 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.
  6. 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.

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: 471kUpdated Claude CodeCodexVerifiedInstall
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: 471kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall