Skip to content

feat(agents): complete agent team setup with gstack skills#130

Merged
ohld merged 3 commits intoproductionfrom
feat/agent-team-setup
Mar 27, 2026
Merged

feat(agents): complete agent team setup with gstack skills#130
ohld merged 3 commits intoproductionfrom
feat/agent-team-setup

Conversation

@ohld
Copy link
Copy Markdown
Member

@ohld ohld commented Mar 27, 2026

Summary

Complete Paperclip agent team overhaul based on /plan-eng-review session:

Agent Structure

  • Added Staff Engineer agent (review + investigate skills) for independent PR review
  • Changed QA reporting line from CEO to CTO (faster bug escalation)
  • Separated CTO and Staff Engineer responsibilities (architect vs reviewer)

Skill Attachments (via Paperclip API, done in-session)

  • Attached gstack skills to all 7 agents via PATCH /api/agents/{id} with desiredSkills
  • Critical fix: skills in AGENTS.md frontmatter are documentation only, Paperclip requires explicit API attachment

Handoff Chain

CTO implements -> PR created -> Staff Engineer /review -> Release Engineer /ship -> QA /canary

Monitoring

  • Sentry webhook configured: new issues wake QA agent for immediate triage
  • 30-min fallback routine catches anything webhooks miss

CI/CD

  • GitHub Actions: ruff lint + pytest on every PR
  • Branch protection enabled on production (requires lint + test checks)

Config Updates

  • Full secrets mapping in .paperclip.yaml (DB, Coolify, Sentry, GH tokens per agent)
  • Comms Manager references dania-zip tone-of-voice repo
  • All AGENTS.md files updated with correct handoff targets and skill lists

Changes done via Paperclip API (not in this diff)

  • Created Staff Engineer agent (ID: 1a323bb6)
  • Attached gstack skills to all 7 agents
  • Updated QA reportsTo from CEO to CTO
  • Enabled Sentry webhook plugin -> QA wake endpoint
  • Enabled GitHub branch protection on production

Test plan

  • Agent instructions synced to Paperclip server via SCP
  • Sentry webhook enabled and configured (verified via API)
  • Branch protection enabled (verified via GitHub API)
  • GitHub PR webhook for Staff Engineer (manual setup needed)
  • QA routine frequency update to 30min (manual in Paperclip dashboard)
  • Sentry webhook end-to-end test (trigger test error)

ohld and others added 3 commits March 27, 2026 13:55
@ohld
feat(agents): complete agent team setup with gstack skills
c752735 
- Add Staff Engineer agent (review, investigate skills)
- Align all agent skill assignments with gstack template
- Fix QA reporting line: CEO -> CTO
- Remove CTO self-review (Staff Engineer handles independent review)
- Add full secrets mapping in .paperclip.yaml
- Update handoff chain: CTO -> Staff Eng -> Release Eng -> QA
- Reference dania-zip tone-of-voice repo for Comms Manager
- Add GitHub Actions CI (lint + test on PRs)
- Update README with org chart, handoff flow, webhook triggers
@ohld
feat(ci): add Staff Engineer PR review trigger via GitHub Actions
5dee5ee 
GitHub webhooks can't send Bearer tokens (they use HMAC signatures).
Use GitHub Actions workflow to fire the Paperclip routine trigger with
proper auth on PR open events.
@Paperclip-Paperclip
fix(ci): correct requirements path, pin ruff version, restore CTO /in…
4057e89 
…vestigate skill

- ci.yml: fix test job pip install path (requirements.txt -> requirements/dev.txt)
- ci.yml: pin ruff to 0.1.9 in lint job to match requirements/dev.txt
- agents/cto: restore /investigate skill and instruction
- agents/staff-engineer: add gh CLI API fallback note

Fixes all 4 issues raised in PR #130 review.

Co-Authored-By: Paperclip <noreply@paperclip.ing>
@ohld ohld merged commit dafdafc into production Mar 27, 2026
1 of 3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@ohld