docs-maintain

name	docs-maintain
description	Keep ARCHITECTURE/README/PROGRESS (and full-scenario GOTCHAS/TESTING/deployment) fresh for Claude Lane Stack projects after daily code changes. Use when: nightly docs, docs-maintain, обновить документацию, актуализировать ARCHITECTURE.

Docs maintain

Who

Codex gpt-5.6-terra + high via docs-maintainer or bin:

docs-maintain-project /path/to/repo "24 hours ago"
docs-maintain-all "24 hours ago"           # scan ~/apps ~/sites ~/tools
docs-maintain-all "24 hours ago" --dry-run

Markers (project is Lane Stack)

• CLAUDE.md contains Claude Lane Stack, or
• .agents/routing.profile.yaml, or
• .agents/runs/ exists

Scenario

Read .agents/onboard.scenario.yaml if present:

scenario	Maintain
minimal	ARCHITECTURE, README agent sections, PROGRESS, CLAUDE pointers only. Do not create full-pack files.
full	Also GOTCHAS/gotchas, TESTING, deployment, nested package CLAUDE when the diff touches those areas.

Never create UPPERCASE duplicates when lowercase wiki pages already exist.

Rules

• Skip if no substantive commits since window.
• Surgical updates only.
• No feature code. Report in .agents/session-log/DOCS-YYYY-MM-DD.md.

Cron

0 3 * * * $HOME/.agents/bin/docs-maintain-all "24 hours ago" >>/tmp/docs-maintain.log 2>&1