Project Maintenance Flow
Last updated: 2026-06-13
This diagram shows how recurring captures, project docs, handoffs, incidents,
and follow-up plans fit together.
Maintenance Loop
flowchart TB
LiveSystems["Live systems\nSynology, UniFi, Pi-holes, Google Cloud DNS, desktop"]
Helpers["Project helper scripts\nPowerShell + read-only SSH helpers"]
Snapshots["Timestamped snapshots\ninventory, health, config, performance"]
Weekly["Weekly maintenance report\nreports/weekly-maintenance"]
Retention["Retention dry-run\ncleanup candidates only"]
Incidents["Incident summaries\nincidents/YYYY-MM-DD-*"]
Docs["Current-state docs\nREADME, HANDOFF, CURRENT_STATE"]
Diagrams["Diagrams and maps\ndiagrams/ + Homepage links"]
Future["Future change list\nFUTURE_CHANGES.md"]
NewChat["NEW_CHAT_HANDOFF.md\nnew-session recovery"]
WindowsTask["Windows scheduled task\nweekly read-only capture"]
CodexReview["Codex automations\nweekly review + Monday doc refresh"]
LiveSystems --> Helpers
Helpers --> Snapshots
Snapshots --> Weekly
WindowsTask --> Weekly
Weekly --> Retention
Weekly --> Docs
Weekly --> Incidents
Incidents --> Docs
Docs --> Diagrams
Diagrams --> NewChat
Docs --> NewChat
Future --> NewChat
CodexReview --> Docs
CodexReview --> Future
CodexReview --> Diagrams
Documentation Boundaries
flowchart LR
Raw["Raw captures\nshort/medium retention"]
Summary["Summaries and findings\nlong retention"]
Handoff["Handoff docs\nalways refreshed"]
Diagrams["Diagrams/Homepage links\noperator navigation"]
Scripts["Scripts and script docs\nkept and commented"]
Retention["Retention policy\nexact approval before deletion"]
Raw -->|"distill important events"| Summary
Summary --> Handoff
Summary --> Diagrams
Scripts --> Handoff
Raw --> Retention
Standing Rules
- Scripts are retained and documented; they should not be deleted during normal
- Raw logs can age out according to the retention policy once useful evidence
- New major findings should update both the relevant subsystem current-state
- Risky operations such as deletion, repair, prune, wipe, or reformat require
cleanup.
has been summarized.
file and NEW_CHAT_HANDOFF.md.
explicit user approval.