OthmanAdi/planning-with-files / skills/i18n/planning-with-files-de
planning-with-files-de
VerifiedPersistente dateibasierte Planung für mehrstufige Arbeit mit KI-Agenten. Hält task_plan.md, findings.md und progress.md auf dem Datenträger; Lebenszyklus-Hooks speisen ausgewählten Planungskontext des Projekts ein. Die automatische Wiederherstellung liest nur die Planungsdateien des Projekts. Nur ein ausdrücklicher Aufruf von session-catchup.py --metadata darf lokale Sitzungsmetadaten desselben Projekts prüfen; --replay darf begrenzte, nonce-gerahmte Auszüge ausgeben. Der optionale Gate-Modus kann nur bei Unterstützung durch den Host eine Fortsetzung anfordern und führt niemals in Markdown angegebene Befehle aus. Der Skill hat keinen Netzwerk-Uploadpfad. Verwenden für Forschung oder Arbeit mit mehr als 5 Tool-Aufrufen.
scripts/ledger-summary.ps1
View on GitHub#requires -Version 5.0
<#
.SYNOPSIS
Emit a fixed-shape, cache-stable run-ledger summary (PowerShell mirror, v3).
.DESCRIPTION
Replaces raw progress.md tail injection in autonomous mode. Output is
synthesized from the machine ledger and task_plan.md status counts only:
NO free text from disk reaches model context, and NO timestamps, so the
injected block is KV-cache stable by construction (architecture C3).
Plan-dir resolution matches resolve-plan-dir.ps1:
1. $env:PLAN_ID -> .\.planning\$PLAN_ID\
2. .\.planning\.active_plan
3. Newest .\.planning\<dir>\ by LastWriteTime
4. Legacy: project root
Output block (stable shape):
=== RUN LEDGER ===
entries: <N>
phases: <complete>/<total> complete
in_progress: <phase heading or none>
agent <name>: <last event type>
==================
#>
[CmdletBinding()]
param()
$ErrorActionPreference = "Stop"
function Resolve-PlanDir {
$planRoot = Join-Path (Get-Location) ".planning"
# A set PLAN_ID is a BINDING, not a hint (issue #237). A selector that
# names no plan directory stops resolution instead of falling through to
# .active_plan, newest-by-mtime and finally the cwd: summarizing another
# plan's ledger under a mistyped pin is the same wrong-plan harm that let
# a typo attest the wrong file.
if ($env:PLAN_ID) {
$candidate = Join-Path $planRoot $env:PLAN_ID
if (Test-Path -LiteralPath $candidate -PathType Container) { return $candidate }
return $null
}
$activePointer = Join-Path $planRoot ".active_plan"
if (Test-Path -LiteralPath $activePointer) {
$planId = "$(Get-Content -LiteralPath $activePointer -Raw -ErrorAction SilentlyContinue)".Trim()
if ($planId) {
$candidate = Join-Path $planRoot $planId
if (Test-Path -LiteralPath $candidate -PathType Container) { return $candidate }
}
}
if (Test-Path -LiteralPath $planRoot -PathType Container) {
$newest = Get-ChildItem -LiteralPath $planRoot -Directory -ErrorAction SilentlyContinue |
Where-Object { -not $_.Name.StartsWith(".") } |
Where-Object { Test-Path -LiteralPath (Join-Path $_.FullName "task_plan.md") } |
Sort-Object LastWriteTime -Descending |
Select-Object -First 1
if ($newest) { return $newest.FullName }
}
return (Get-Location).Path
}
$planDir = Resolve-PlanDir
if (-not $planDir) {
# Loud degradation, same contract as ledger-summary.sh's emit_unavailable:
# a rejected PLAN_ID binding must not report the ROOT plan's phase counts,
# because an autonomous loop reads those counts as its termination signal.
Write-Output "=== RUN LEDGER ==="
Write-Output "ledger: unavailable (explicit PLAN_ID did not resolve)"
Write-Output "=================="
exit 0
}
$planFile = Join-Path $planDir "task_plan.md"
$TOTAL = 0
$COMPLETE = 0
$IN_PROGRESS = 0
$inProgressHeading = "none"
$phaseReadError = $false
$fence = ""
if (Test-Path -LiteralPath $planFile) {
try {
$content = Get-Content -LiteralPath $planFile -Raw -Encoding UTF8 -ErrorAction Stop
} catch { $phaseReadError = $true }
# Count native statuses inside real phases, excluding fenced examples (#377).
$counts = @{ total = 0; complete = 0; in_progress = 0; pending = 0 }
$phase = $null
$invalid = $false
$activeHeading = ""
$fence = ""
$fenceLength = 0
$malformedHeading = $false
function Complete-Phase {
if ($null -ne $script:phase) {
if ($script:phase.Statuses.Count -ne 1) { $script:invalid = $true }
else {
$state = $script:phase.Statuses[0]
if ($state -ne 'in_progress') { $script:counts[$state]++ }
}
if ($script:phase.Statuses -contains 'in_progress') {
$script:counts.in_progress++
if (-not $script:activeHeading) { $script:activeHeading = $script:phase.Heading }
}
}
$script:phase = $null
}
foreach ($line in (($content -creplace '^\uFEFF', '') -split '\r?\n')) {
if ($fence) {
if ($line -match ('^ {0,3}' + [regex]::Escape($fence) + '{' + $fenceLength + ',}[ \t]*$')) { $fence = "" }
continue
}
if ($line -match '^ {0,3}(`{3,}|~{3,})' -and
($Matches[1][0] -eq '~' -or -not $line.Substring($Matches[0].Length).Contains('`'))) {
$fence = $Matches[1].Substring(0, 1); $fenceLength = $Matches[1].Length
continue
}
if ($line -match '^ {0,3}>') { continue }
if ($line -cmatch '^ {0,3}### Phase(?:[0-9:]|-[0-9])') {
Complete-Phase
$malformedHeading = $true
continue
}
if ($line -cmatch '^ {0,3}### Phase(?:[ \t]|$)') {
Complete-Phase
$counts.total++
$phase = @{ Heading = $line; Statuses = @() }
} elseif ($line -match '^ {0,3}#{1,3}(?:[ \t]|$)') {
Complete-Phase
}
if ($null -ne $phase) {
foreach ($match in [regex]::Matches($line, '\*\*Status:\*\*[ \t]+(pending|in_progress|complete)(?![A-Za-z0-9_])|\[(pending|in_progress|complete)\]')) {
$state = $match.Groups[1].Value
if (-not $state) { $state = $match.Groups[2].Value }
$phase.Statuses += $state
}
}
}
Complete-Phase
$TOTAL = $counts.total
$COMPLETE = $counts.complete
$IN_PROGRESS = $counts.in_progress
$PENDING = $counts.pending
if ($activeHeading) { $inProgressHeading = $activeHeading }
}
# --- Ledger stats ---
$totalEntries = 0
$ledgerFiles = Get-ChildItem -LiteralPath $planDir -Filter "ledger-*.jsonl" -File -ErrorAction SilentlyContinue
foreach ($f in $ledgerFiles) {
$lines = Get-Content -LiteralPath $f.FullName -ErrorAction SilentlyContinue
foreach ($line in $lines) {
if ($line -match '"tick"') { $totalEntries++ }
}
}
Write-Output "=== RUN LEDGER ==="
Write-Output ("entries: " + $totalEntries)
if ($phaseReadError -or $fence -or $malformedHeading) {
Write-Output "phases: unavailable (plan format or read error)"
} else {
Write-Output ("phases: " + $COMPLETE + "/" + $TOTAL + " complete")
}
Write-Output ("in_progress: " + $inProgressHeading)
foreach ($f in $ledgerFiles) {
$agent = $f.Name -replace '^ledger-', '' -replace '\.jsonl$', ''
# @(...) forces array semantics: a single-line file returns a string from
# Get-Content and $lines[-1] would otherwise index the last character.
$lines = @(Get-Content -LiteralPath $f.FullName -ErrorAction SilentlyContinue)
$lastEvent = "none"
if ($lines.Count -gt 0) {
$lastLine = $lines[$lines.Count - 1]
$m = [regex]::Match($lastLine, '"event"\s*:\s*"([A-Za-z_]+)"')
if ($m.Success) { $lastEvent = $m.Groups[1].Value }
}
Write-Output ("agent " + $agent + ": " + $lastEvent)
}
Write-Output "=================="
exit 0
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |