Route repo changes through the correct validation, generated-doc regeneration, plugin sync, and maintenance commands. Use when the task is developer upkeep, doc drift, plugin upkeep, app-surface maintenance, or figuring out the smallest correct verification loop.
Use this skill for developer maintenance and repo-upkeep work in /home/irene/Edge.
docs/README.mddocs/operator_command_inventory.mddocs/92_assurance_and_benchmarks.mdMakefileproject/tests/ as the only pytest root; tmp/, .tmp/, live/persist/, artifacts/, and logs/ are local-only scratch.Use:
make check-hygiene
./plugins/edge-agents/scripts/edge_verify_contracts.sh
./plugins/edge-agents/scripts/edge_validate_repo.sh minimum-green
Then inspect:
README.mddocs/README.mddocs/00_overview.mddocs/operator_command_inventory.mdUse:
make check-hygiene
./plugins/edge-agents/scripts/edge_verify_contracts.sh
PYTHONPATH=. ./.venv/bin/python -m project.scripts.build_event_contract_artifacts
PYTHONPATH=. ./.venv/bin/python -m project.scripts.build_system_map
Then inspect:
docs/generated/event_contract_completeness.mddocs/generated/event_tiers.mddocs/02_REPOSITORY_MAP.mddocs/90_architecture.mdUse:
make check-hygiene
./plugins/edge-agents/scripts/edge_verify_contracts.sh
./plugins/edge-agents/scripts/edge_export_theses.sh <run_id>
PYTHONPATH=. ./.venv/bin/python -m project.scripts.build_thesis_overlap_artifacts --run_id <run_id>
Then inspect:
data/live/theses/<run_id>/promoted_theses.jsondata/live/theses/index.jsondocs/generated/thesis_overlap_graph.mddocs/03_promote.mddocs/04_deploy.mdUse:
make check-hygiene
./plugins/edge-agents/scripts/edge_verify_contracts.sh
PYTHONPATH=. ./.venv/bin/python -m project.scripts.build_system_map
Then inspect:
docs/90_architecture.mddocs/02_REPOSITORY_MAP.mddocs/generated/system_map.mdUse:
make validate
Then inspect:
project/live/deployment.py — DeploymentGate contractproject/live/contracts/deployment_approval.py — DeploymentApprovalRecord schemaproject/live/audit_log.py — audit event types and JSONL writerproject/live/kill_switch.py — per-thesis/symbol/family disable/resume controlsproject/live/contracts/promoted_thesis.py — DeploymentState lifecycle and LIVE_TRADEABLE_STATESdata/live/audit.jsonl — append-only live action log (if runtime has run)Key invariants:
ThesisStore.from_path() enforces DeploymentGate at load — violations raise RuntimeErrorlive_enabled requires: DeploymentApprovalRecord with status='approved', approved_by, approved_at, risk_profile_id, and configured cap_profileUse:
./plugins/edge-agents/scripts/edge_sync_plugin.sh check
./plugins/edge-agents/scripts/edge_sync_plugin.sh sync
Use:
make check-hygiene
./plugins/edge-agents/scripts/edge_validate_repo.sh contracts
./plugins/edge-agents/scripts/edge_validate_repo.sh minimum-green
./plugins/edge-agents/scripts/edge_governance.sh
When the task touches project/apps/chatgpt/, use:
./plugins/edge-agents/scripts/edge_chatgpt_app.sh backlog
./plugins/edge-agents/scripts/edge_chatgpt_app.sh blueprint
./plugins/edge-agents/scripts/edge_chatgpt_app.sh widget
./plugins/edge-agents/scripts/edge_chatgpt_app.sh serve --host 127.0.0.1 --port 8000 --path /mcp
Treat this as an interface layer around canonical operator surfaces, not a separate runtime.
docs/generated/* when a generator exists; use project/scripts/regenerate_artifacts.sh.make validate if the change type implies additional regeneration.