Co-authored-by: blackboxprogramming <118287761+blackboxprogramming@users.noreply.github.com>
1.1 KiB
1.1 KiB
🚀 Deploy Logs
Purpose: What shipped, when, from where, by whom/which agent
Updated: 2025-11-25
Overview
This directory contains deploy logs — append-only records of what was deployed, when, and by whom.
🧪 Invariants
Every deploy log entry must have:
- 🧬 Stable ID:
DEPLOY-YYYYMMDD-XXX - ⏱️ Timestamp: Precise with timezone/UTC
- 🧭 Context tags: env, service, org, agent
Entry Format
# Deploy: [service-name] @ YYYY-MM-DD HH:MM:SS UTC
**ID:** DEPLOY-YYYYMMDD-XXX
**Service:** [service-name]
**Env:** [production | staging | development]
**Version:** [version-tag or commit SHA]
**Agent:** [agent:name | human:username]
**Source Repo:** `BlackRoad-OS/[repo-name]`
**Source Commit:** [full git SHA]
---
## Summary
[Brief description of what was deployed]
## Changes Included
- [Change 1]
- [Change 2]
## Related
- [Links to PRs, issues, or other logs]
File Naming
Use: YYYY-MM-DD-service-name-XXX.md
Example: 2025-11-25-blackroad-api-001.md
This is append-only history. Corrections are new entries that reference old ones. 🧾