37 lines
1.5 KiB
Markdown
37 lines
1.5 KiB
Markdown
|
---
|
||
|
|
brief: 4
|
||
|
|
convoy: owner-cockpit-v02
|
||
|
|
role: role-doc-writer
|
||
|
|
title: Doc-writer SOPs — webhook secret rotation + copilot prompt
|
||
|
|
status: ready
|
||
|
|
priority: P2
|
||
|
|
slice_dependencies: [1]
|
||
|
|
recommended_model: qwen-coder
|
||
|
|
model_tier: local
|
||
|
|
---
|
||
|
|
|
||
|
|
# Brief 4 — `role-doc-writer` SOPs for owner cockpit
|
||
|
|
|
||
|
|
## Goal
|
||
|
|
|
||
|
|
Document rotation and prompts so future agents read them as second-brain context, not just code.
|
||
|
|
|
||
|
|
## Files
|
||
|
|
|
||
|
|
- `docs/operations/webhook-secret-rotation.md` NEW — one page: where `FORGE_WEBHOOK_SECRET` lives (Coolify env), how to rotate (generate `openssl rand -hex 32`, update Forgejo webhook + Coolify `FORGE_WEBHOOK_SECRET`, test via `curl -H 'X-Hub-Signature-256: sha256=...' http://localhost:3000/api/webhooks/forge`).
|
||
|
|
- `docs/copilot-prompt.md` NEW — system prompt for `gate-copilot` and `ops copilot` (reuse `convoys.ts:gut` prompt but versioned in `docs/` for harness portability).
|
||
|
|
- `docs/examples/sop-published-flow.md` NEW — one SOP showing `Task-write-sop → doc_review → published → artifact gallery` e2e with screenshots placeholder.
|
||
|
|
|
||
|
|
## Acceptance
|
||
|
|
|
||
|
|
- Three docs exist, linked from `docs/README` or `docs/operations/live-e2e-checklist.md`.
|
||
|
|
- No code, only markdown; `pnpm lint` still passes (markdown ignored).
|
||
|
|
|
||
|
|
## Prompt
|
||
|
|
|
||
|
|
You are `role-doc-writer` brief 4. Read `docs/convoy-lifecycle.md`, `apps/web/app/api/webhooks/forge/route.ts` (once brief 1 lands) to document accurately. Keep docs small, imperative, no narration.
|
||
|
|
|
||
|
|
## Depends
|
||
|
|
|
||
|
|
Brief 1 — needs webhook route to document accurately.
|