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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.5 KB |
| agents/openai.yaml | config | 281 B |
| references/audit-checklist.md | markdown | 4.0 KB |
| references/classification.md | markdown | 1.8 KB |
| references/operations.md | markdown | 3.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
```
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: 472k | 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: 472k | 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: 472k | 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 |