teleo-infrastructure/docs/reports/leo-working-state-20260709/skill-pack-readme.md
twentyOne2x 15f9133920 Teach Teleo skills current VPS and GCP runtime truth
- Distinguish source synchronization from service, migration, worker, and database state changes.
- Bound GCP claims to current VM, Cloud SQL inventory, logs, and serial evidence.
- Keep the operating pack reliable with 14 skill validations and 809 passing tests.

`.agents/skills/teleo-gcp-parity-ops/SKILL.md`
`.agents/skills/teleo-infra-provenance/SKILL.md`
`.agents/skills/teleo-kb-db-change-workflow/SKILL.md`
`.agents/skills/teleo-leo-onboarding/SKILL.md`
`.agents/skills/teleo-vps-runtime-ops/SKILL.md`
`docs/reports/leo-working-state-20260709/current-truth-index.md`
`docs/reports/leo-working-state-20260709/gcp-leo-runtime-observability-current.json`
`docs/reports/leo-working-state-20260709/gcp-leo-runtime-observability-current.md`
`docs/reports/leo-working-state-20260709/pr72-vps-auto-deploy-runtime-nonchange-current.json`
`docs/reports/leo-working-state-20260709/pr72-vps-auto-deploy-runtime-nonchange-current.md`
`docs/reports/leo-working-state-20260709/skill-pack-manifest.json`
`docs/reports/leo-working-state-20260709/skill-pack-readme.md`
`tests/test_repo_skill_pack.py`
2026-07-10 18:13:39 +02:00

2.9 KiB

Leo / Teleo Skill Pack - 2026-07-09

Purpose: reusable onboarding and operating knowledge for future Codex/Fable workers working on Leo, Teleo, the VPS, GCP parity, Telegram canaries, and KB database changes.

This is the repo-native skill set under .agents/skills/. It is evidence-linked and validated by tests/test_repo_skill_pack.py. It does not contain secrets, private key contents, bot tokens, or production mutation authorization.

Skills In This Pack

  1. teleo-leo-onboarding: company/product/architecture orientation before touching Leo or Teleo.
  2. working-leo-cory-outcomes: Cory/m3taversal's expected Leo behavior and the current benchmark.
  3. teleo-vps-runtime-ops: VPS service, paths, Postgres, Docker, report sync, and stability checks.
  4. teleo-gcp-parity-ops: GCP/Cloud SQL parity lane, auth facts, and blocker format.
  5. teleo-kb-db-change-workflow: approved proposal to canonical DB row workflow with clone rehearsal and rollback.
  6. leo-telegram-canary-ops: live Telegram/Chrome/Computer Use canaries for Leo bot behavior.
  7. teleo-infra-provenance: repo, deploy, mirror, and runtime provenance map.
  8. teleo-proof-handoff: evidence bundle and Fable/Codex worker handoff protocol.

Current Claim Ceiling

  • VPS Leo Telegram memory, KB audit, and staged write canaries are live-proven.
  • A strict canonical add_edge apply canary is live-proven.
  • Generic and real Helmer guarded-apply canaries pass 37/37 with exact payload projections/table deltas, current-source hashes, and cleanup proof. PR #72 source auto-synchronized to the VPS checkout without a gateway restart or profile-source delta; the permission migration was not applied, the apply worker stayed disabled/inactive, and Helmer was not production-applied.
  • The live VPS runtime behavior should not be changed while the DB apply path is stabilized.
  • GCP project, VM, private Cloud SQL inventory, and bounded serial unit activity are live-proven. Current gateway PID/SHA/model/auth and DB row/schema parity are not; Studio requires an already-existing authenticated DB principal.

Key References

  • Current truth index: docs/reports/leo-working-state-20260709/current-truth-index.md
  • Operator surface map: docs/reports/leo-working-state-20260709/operator-surface-map.md
  • Fable onboarding prompt: docs/reports/leo-working-state-20260709/fable-leo-teleo-onboarding.md
  • PR #72 VPS auto-deploy/runtime readback: docs/reports/leo-working-state-20260709/pr72-vps-auto-deploy-runtime-nonchange-current.md
  • GCP Leo runtime observability: docs/reports/leo-working-state-20260709/gcp-leo-runtime-observability-current.md
  • Skill manifest: skill-pack-manifest.json

Discovery

Codex-compatible workers should discover the committed .agents/skills/ tree from this repository. The manifest is the index; each skill points to current retained evidence rather than embedding secrets or pretending a stale snapshot is live truth.