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.

FileKindSize
SKILL.mdskill md3.5 KB
agents/openai.yamlconfig281 B
references/audit-checklist.mdmarkdown4.0 KB
references/classification.mdmarkdown1.8 KB
references/operations.mdmarkdown3.6 KB

references/operations.md

View on GitHub
# Full Documentation Audit Operations

Use this workflow for a full audit. Its six-pass and whole-map requirements do
not apply to scoped corrections; those follow the entrypoint and affected
checklist items. If reusing a command below for a scoped task, restrict it to
the affected files and incoming references. Run commands from the repository
root.

Audit mode is read-only: deletion, migration and map changes are proposals.
Follow the entrypoint's authorization boundary before applying any cleanup.

## Workflow

1. Follow `CONTRIBUTING.md`, reusing applicable material already read.
2. Inventory docs and references:

   ```powershell
   Get-ChildItem -Path . -Include *.md -Recurse -File |
     Where-Object { $_.FullName -notmatch '\\.git\\|\\bin\\|\\obj\\|\\Library\\|\\Temp\\' } |
     Select-Object FullName,Length |
     Sort-Object FullName
   ```

3. Scan headings to identify plans, roadmaps, archive sections, and duplicate
   entry points:

   ```powershell
   rg -n "^#|^##|^###" CONTRIBUTING.md docs CHANGELOG.md
   ```

4. Run all six passes in the Complete Quality Audit Checklist and keep an
   evidence-backed result for each pass.

5. Check incoming references when proposing deletion or migration:

   ```powershell
   rg -n "path-or-filename-to-delete" CONTRIBUTING.md docs README.md CHANGELOG.md
   ```

6. Report findings, evidence, proposed dispositions and coverage limitations.
   Complete audit verification below, then stop. Do not apply the findings.

## Authorized Cleanup

For findings the user has authorized fixing, check references and edit narrowly:

- delete stale files
- remove links to deleted docs
- compact entry maps
- replace completed phase sections with current contracts only when the
  contract is still useful

Repeat the affected checklist passes after editing. A cleanup is incomplete
if it fixes one document while leaving a conflicting authority or duplicate
mutable fact elsewhere.

Remove temporary planning docs created during the cleanup before finishing.

## Verification

Before claiming a full audit complete:

- Confirm the six audit passes have explicit results and evidence.
- Confirm every current authority is mapped by `CONTRIBUTING.md` and every
  mapped target exists.
- For authorized cleanup, re-run only searches whose results may have changed,
  covering affected duplicate facts, competing authority markers, and transitional
  wording. Review remaining matches in that scope as intentional. Reuse valid
  evidence for unchanged areas rather than restarting the full audit.

```powershell
rg -n "deleted-file-name|deleted-directory-name" CONTRIBUTING.md docs README.md CHANGELOG.md
```

```powershell
$errors = @()
$files = @('CONTRIBUTING.md','CHANGELOG.md') + (Get-ChildItem -Path docs -Recurse -Filter *.md | ForEach-Object { $_.FullName })
foreach ($file in $files) {
  $full = if ([System.IO.Path]::IsPathRooted($file)) { $file } else { Join-Path (Get-Location) $file }
  $text = Get-Content -Raw -LiteralPath $full
  $matches = [regex]::Matches($text, '\[[^\]]+\]\(([^)]+)\)')
  foreach ($match in $matches) {
    $target = $match.Groups[1].Value
    if ($target -match '^[a-z]+:' -or $target.StartsWith('#') -or $target.StartsWith('mailto:')) { continue }
    $clean = ($target -split '#')[0]
    if ([string]::IsNullOrWhiteSpace($clean)) { continue }
    if ($clean -notmatch '\.md$') { continue }
    $resolved = Join-Path (Split-Path -Parent $full) $clean
    if (-not (Test-Path -LiteralPath $resolved)) { $errors += "$file -> $target" }
  }
}
if ($errors.Count -gt 0) {
  $errors | ForEach-Object { Write-Output $_ }
  exit 1
}
```

```powershell
git diff --check
```
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: 472kUpdated 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: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated 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