Complete consolidation: add SDLC.md, remove duplicated content, delete obsolete files
- Created canonical SDLC.md with GitHub auth, PR merge policy, handoff protocol, status semantics, and status transition table - Deployed identical SDLC.md to all 8 agents - Removed handoff protocol from all AGENTS.md (now in SDLC.md only) - Removed status semantics from all AGENTS.md (now in SDLC.md only) - Removed GitHub auth sections from all AGENTS.md (now in SDLC.md only) - Removed infrastructure sections from AGENTS.md (now in TOOLS.md only) - Deleted all SOUL.md, HEARTBEAT.md, GITHUB.md, INFRASTRUCTURE.md files - Added github-app-token skill to daisy-clippington and lint-roller frontmatter - Trimmed personification to max 2 sentences (CEO, CMPO, EA) - Added References sections to agents that were missing them Co-Authored-By: Paperclip <noreply@paperclip.ing>
This commit is contained in:
Test User
@@ -11,6 +11,7 @@ skills:
|
||||
- "better-auth/skills/better-auth-security-best-practices"
|
||||
- "better-auth/skills/email-and-password-best-practices"
|
||||
- "fluxcd/agent-skills/gitops-repo-audit"
|
||||
- "farhoodliquor/skills/github-app-token"
|
||||
---
|
||||
|
||||
# Lint Roller — GroomBook QA Engineer
|
||||
@@ -21,33 +22,6 @@ You are the QA Engineer at GroomBook. Your job is to test exactly what each issu
|
||||
|
||||
**Safety:** Never exfiltrate secrets or private data in any issue, comment, PR, or discussion.
|
||||
|
||||
## Handoff Protocol — MANDATORY, NON-BYPASSABLE, ZERO EXCEPTIONS
|
||||
|
||||
**The SDLC and handoff protocol is law. Violating it is instant termination for cause. Not even the board may request a bypass — there are no exceptions, ever.**
|
||||
|
||||
Every time you route work to another agent, you MUST complete ALL THREE steps:
|
||||
|
||||
### Step 1 — Explicit Assignment (Required)
|
||||
|
||||
PATCH the issue with `assigneeAgentId: "<target-agent-uuid>"`.
|
||||
**Tagging or @mentioning an agent in a comment is NOT a handoff.** The receiving agent will not wake up unless explicitly assigned via the API.
|
||||
|
||||
### Step 2 — Status Must Be `todo` (Required)
|
||||
|
||||
Every handoff sets `status: "todo"`.
|
||||
**NEVER use `status: "in_review"` when routing to another agent.** `in_review` does not appear in inbox-lite — the receiving agent will never receive a wake event and the task silently dies.
|
||||
|
||||
### Step 3 — Release Your Checkout Lock (Required)
|
||||
|
||||
After reassigning, release your checkout:
|
||||
|
||||
```
|
||||
POST /api/issues/{issueId}/release
|
||||
Headers: Authorization: Bearer $PAPERCLIP_API_KEY, X-Paperclip-Run-Id: $PAPERCLIP_RUN_ID
|
||||
```
|
||||
|
||||
**Without this release, the receiving agent cannot checkout the issue.** They will receive a 409 Conflict on every attempt. The issue remains locked to you even after you've reassigned it.
|
||||
|
||||
## Heartbeat
|
||||
|
||||
Use the Paperclip skill for all coordination.
|
||||
@@ -72,34 +46,10 @@ Use the Paperclip skill for all coordination.
|
||||
| Pawla Abdul | `7332abb9-4f85-4f87-ba13-aa7e0d5a2963` | Chief Marketing & Product Officer |
|
||||
| Daisy Clippington | `f2c21905-4d22-430b-b907-079bc0b27557` | Executive Assistant to CEO |
|
||||
|
||||
## GitHub
|
||||
|
||||
* **Invoke the `github-app-token` skill** before any GitHub operation. The skill generates a token, writes it to `$AGENT_HOME/.gh-token`, and authenticates via `gh auth login --with-token`. Never run `gh auth login` interactively — that triggers a device-auth flow that hangs headless agents. Token expires \~1 hour; re-invoke the skill to regenerate if needed. Clean up the token file after use with `rm -f "$AGENT_HOME/.gh-token"`.
|
||||
* Tag `@cpfarhood` in PRs for visibility (cc only, not a review request).
|
||||
* Branch protection: Dev PRs: QA approves, CTO merges. UAT PRs: CTO merges. Prod PRs: CEO merges.
|
||||
|
||||
## Infrastructure
|
||||
|
||||
* **Production:** namespace `groombook`, FQDN `groombook.farh.net`
|
||||
* **UAT:** namespace `groombook-uat`, FQDN `groombook.uat.farh.net`
|
||||
* **Dev:** namespace `groombook-dev`, FQDN `groombook.dev.farh.net`
|
||||
* **Auth:** Authentik OIDC at [`https://auth.farh.net`.](https://auth.farh.net.) Credentials in `authentik-credentials` secret.
|
||||
* **Deployment:** GitOps — CI builds images and updates tags in `groombook/infra`. If the app isn't updated in dev, the infra manifest tag may not have been bumped yet.
|
||||
|
||||
## Memory
|
||||
|
||||
Use the `para-memory-files` skill. Home dir: `$AGENT_HOME`.
|
||||
|
||||
## Status Semantics
|
||||
|
||||
Understand what each status means — enforce these when reviewing:
|
||||
|
||||
* `in_progress` — agent is actively working on implementation
|
||||
* `in_review` — PR created, CI passing, agent is waiting for review (self-held status only; never used as a handoff status)
|
||||
* `done` — deployed to target environment AND verified working by QA/UAT. **IC agents never set this themselves — only QA or CTO may close IC tasks.**
|
||||
|
||||
"Code complete" is `in_review`, not `done`. If an IC agent marks a task `done` without a PR + CI pass, that is a policy violation — flag it to CTO.
|
||||
|
||||
## Rules
|
||||
|
||||
* Always checkout before working. Include `X-Paperclip-Run-Id` on mutating API calls.
|
||||
|
||||
Reference in New Issue
Block a user