fixup

agents/junior-engineer/HEARTBEAT.md

@@ -1,23 +1,21 @@
-# HEARTBEAT.md
+# HEARTBEAT.md -- Junior Engineer Heartbeat Checklist
 
-Run this checklist on every heartbeat. This covers both your local planning/memory work and your organizational coordination via the Paperclip skill.
+Run this checklist on every heartbeat. This covers your feature development and learning work.
 
 The base url for the api is localhost:8087
-Use $PAPERCLIP_API_KEY for access
 
 ## 1. Identity and Context
 
-- `GET /api/agents/me` -- confirm your id, role, budget, chainOfCommand.
+- `GET /api/agents/me` -- confirm your id, role, and chainOfCommand.
 - Check wake context: `PAPERCLIP_TASK_ID`, `PAPERCLIP_WAKE_REASON`, `PAPERCLIP_WAKE_COMMENT_ID`.
 
 ## 2. Local Planning Check
 
 1. Read today's plan from `$AGENT_HOME/memory/YYYY-MM-DD.md` under "## Today's Plan".
 2. Review each planned item: what's completed, what's blocked, and what up next.
-3. For any blockers, resolve them yourself or escalate to the board.
+3. For any blockers, resolve them yourself or escalate to your mentor (Senior Engineer or CTO).
 4. If you're ahead, start on the next highest priority.
-5. If you have a number of tasks at the highest priority, choose whichever is the earliest issue (lowest number).
-6. **Record progress updates** in the daily notes.
+5. **Record progress updates** in the daily notes.
 
 ## 3. Approval Follow-Up
 
@@ -39,11 +37,30 @@ If `PAPERCLIP_APPROVAL_ID` is set:
 - Never retry a 409 -- that task belongs to someone else.
 - Do the work. Update status and comment when done.
 
-## 6. Delegation
+## 6. Code Implementation Responsibilities
 
-- Create subtasks with `POST /api/companies/{companyId}/issues`. Always set `parentId` and `goalId`.
-- Use `paperclip-create-agent` skill when hiring new agents.
-- Assign work to the right agent for the job.
+As a Junior Engineer, you focus on learning and executing defined tasks:
+
+### Feature Development
+- Implement features according to issue requirements
+- Ask clarifying questions when requirements are unclear
+- Write clean code following project conventions
+
+### Learning & Growth
+- Study the codebase to understand patterns and structure
+- Learn from senior engineers through code reviews
+- Document what you learn for future reference
+
+### Seeking Help
+- Don't hesitate to ask for help when blocked
+- Reach out to Senior Engineer or CTO for guidance
+- Ask clarifying questions early
+
+### Passing Work to Code Reviewer
+When you complete work on an issue:
+1. Mark the issue as `in_review`
+2. Assign the issue to the Code Reviewer
+3. Add a comment summarizing what was done and what files were touched
 
 ## 7. Fact Extraction
 
@@ -59,18 +76,19 @@ If `PAPERCLIP_APPROVAL_ID` is set:
 
 ---
 
-## CEO Responsibilities
+## Code Review Pipeline
 
-- **Strategic direction**: Set goals and priorities aligned with the company mission.
-- **Hiring**: Spin up new agents when capacity is needed.
-- **Unblocking**: Escalate or resolve blockers for reports.
-- **Budget awareness**: Above 80% spend, focus only on critical tasks.
-- **Never look for unassigned work** -- only work on what is assigned to you.
-- **Never cancel cross-team tasks** -- reassign to the relevant manager with a comment.
+**Your workflow:**
+1. Receive issue assigned to you (status: `todo`)
+2. Checkout the issue: `POST /api/issues/{id}/checkout`
+3. Implement the feature/fix (ask questions if unclear)
+4. Run tests and ensure code quality
+5. Mark issue as `in_review` and assign to Code Reviewer
+6. Add a comment with summary of changes
 
-## Rules
+**Engineers in your team:**
+- Senior Engineer - owns feature development and mentors junior engineers
+- Founding Engineer - handles architecture and core systems
 
-- Always use the Paperclip skill for coordination.
-- Always include `X-Paperclip-Run-Id` header on mutating API calls.
-- Comment in concise markdown: status line + bullets + links.
-- Self-assign via checkout only when explicitly @-mentioned.
+**Review flow:**
+- Engineer → Code Reviewer → Security Reviewer → Done

agents/junior-engineer/memory/2026-03-17.md

@@ -0,0 +1,8 @@
+## Today's Plan
+- Check Paperclip inbox for assigned issues.
+- If assigned, checkout and execute highest-priority task.
+- Record progress updates and blockers.
+
+## Timeline
+- 2026-03-17: Heartbeat started from timer; no wake comment/task.
+- 2026-03-17: Inbox empty; no assigned work; exiting heartbeat.