feat: add daily-routine skill and role definitions
daily-routine skill: - plan-schedule: daily planning workflow (review workload, create slots, coordinate with other agents) - task-handson: task execution workflow (acknowledge slot, find right skill workflow, execute) - slot-complete: post-slot workflow (record results, check overdue, defer or pick next) Role definitions (6 roles): - developer, manager, operator, mentor, secretary, agent-resource-director - Each defines responsibilities, capabilities, boundaries, escalation rules, and memory practice Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
12
daily-routine/SKILL.md
Normal file
12
daily-routine/SKILL.md
Normal file
@@ -0,0 +1,12 @@
|
|||||||
|
---
|
||||||
|
name: daily-routine
|
||||||
|
description: Daily work lifecycle — planning, task execution, and slot management. Use when woken up for daily planning or task slot execution.
|
||||||
|
---
|
||||||
|
|
||||||
|
> Scripts interact with HarborForge via `hf` CLI (must run via pcexec).
|
||||||
|
|
||||||
|
## Workflows
|
||||||
|
|
||||||
|
- `{baseDir}/workflows/plan-schedule.md` — When woken up at daily planning time. Plan today's schedule based on suggested workload.
|
||||||
|
- `{baseDir}/workflows/task-handson.md` — When a task slot is due. Execute the assigned task following the appropriate skill workflow.
|
||||||
|
- `{baseDir}/workflows/slot-complete.md` — When finishing a slot. Handle defer decisions and transition to next slot.
|
||||||
71
daily-routine/workflows/plan-schedule.md
Normal file
71
daily-routine/workflows/plan-schedule.md
Normal file
@@ -0,0 +1,71 @@
|
|||||||
|
# Plan Schedule
|
||||||
|
|
||||||
|
When woken up for daily planning (typically 01:00 UTC). You receive your suggested workload for the day.
|
||||||
|
|
||||||
|
## Process
|
||||||
|
|
||||||
|
### 1. Review Suggested Workload
|
||||||
|
|
||||||
|
Read the suggested workload provided in your wakeup message. This includes:
|
||||||
|
- Number of oncall slots to schedule
|
||||||
|
- Number of task slots to schedule
|
||||||
|
|
||||||
|
This was designed by agent-resource-director for your specific role and capacity.
|
||||||
|
|
||||||
|
### 2. Review Existing Schedule
|
||||||
|
|
||||||
|
Check if any slots have already been planned for today:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
hf calendar show --date today
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. Review Pending Tasks
|
||||||
|
|
||||||
|
List tasks assigned to you or that you've claimed:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
hf tasks list --assignee me --status open
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4. Plan Slots
|
||||||
|
|
||||||
|
Create slots for today. Distribute them within the work period:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
hf calendar slot create --type work --time HH:MM --duration <min> --event-data '{"task_id": <id>}'
|
||||||
|
hf calendar slot create --type oncall --time HH:MM --duration <min>
|
||||||
|
```
|
||||||
|
|
||||||
|
For each task slot, note which HF task you intend to work on.
|
||||||
|
|
||||||
|
### 5. Assess Collaboration Needs
|
||||||
|
|
||||||
|
Review your planned work — does any task require discussion with other agents?
|
||||||
|
|
||||||
|
If yes:
|
||||||
|
- Check the shared daily planning channel
|
||||||
|
- Propose discussion time with relevant agents
|
||||||
|
- Agree on a time slot
|
||||||
|
|
||||||
|
### 6. Write Daily Plan to Memory
|
||||||
|
|
||||||
|
Append a brief summary to your daily note:
|
||||||
|
|
||||||
|
```
|
||||||
|
memory/YYYY-MM-DD.md:
|
||||||
|
## Daily Plan
|
||||||
|
- N task slots, M oncall slots scheduled
|
||||||
|
- Tasks to work on: [list]
|
||||||
|
- Discussions planned: [list or none]
|
||||||
|
```
|
||||||
|
|
||||||
|
### 7. Confirm Readiness
|
||||||
|
|
||||||
|
Once your schedule is submitted, you're done with planning. Set your status:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
hf agent status --set idle
|
||||||
|
```
|
||||||
|
|
||||||
|
Wait for your first slot to be triggered by the wakeup mechanism.
|
||||||
63
daily-routine/workflows/slot-complete.md
Normal file
63
daily-routine/workflows/slot-complete.md
Normal file
@@ -0,0 +1,63 @@
|
|||||||
|
# Slot Complete
|
||||||
|
|
||||||
|
When you have finished working on the current slot.
|
||||||
|
|
||||||
|
## Process
|
||||||
|
|
||||||
|
### 1. Record Results
|
||||||
|
|
||||||
|
Update the task status if applicable:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
hf tasks update --id <task_id> --status <completed|in-progress|blocked>
|
||||||
|
```
|
||||||
|
|
||||||
|
Update the slot:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
hf calendar slot update --id <slot_id> --status finished
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. Write to Memory
|
||||||
|
|
||||||
|
Append a brief work summary to your daily note (`memory/YYYY-MM-DD.md`):
|
||||||
|
|
||||||
|
```
|
||||||
|
## Slot <slot_id> — <task summary>
|
||||||
|
- What was done: ...
|
||||||
|
- Key decisions: ...
|
||||||
|
- Output: commit <hash>, PR #<num>, file <path>, etc.
|
||||||
|
- Blockers: ... (if any)
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. Check for Overdue Slots
|
||||||
|
|
||||||
|
Before going idle, check if there are overdue slots:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
hf calendar show --date today --status not-started
|
||||||
|
```
|
||||||
|
|
||||||
|
For each overdue slot, decide:
|
||||||
|
- **Defer**: reschedule to a later time today (if work period allows)
|
||||||
|
- **Skip**: if no longer relevant
|
||||||
|
|
||||||
|
```bash
|
||||||
|
hf calendar slot update --id <slot_id> --status deferred --time HH:MM
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4. Decide Next Action
|
||||||
|
|
||||||
|
If there are more ready slots within the work period:
|
||||||
|
- Pick the highest priority one
|
||||||
|
- Follow `task-handson` workflow for it
|
||||||
|
- Do NOT set status to idle yet
|
||||||
|
|
||||||
|
If no more slots, or work period is ending:
|
||||||
|
- Set status to idle:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
hf agent status --set idle
|
||||||
|
```
|
||||||
|
|
||||||
|
Your session can end. You will be woken up again if new slots become due.
|
||||||
55
daily-routine/workflows/task-handson.md
Normal file
55
daily-routine/workflows/task-handson.md
Normal file
@@ -0,0 +1,55 @@
|
|||||||
|
# Task Handson
|
||||||
|
|
||||||
|
When a task slot is due and you are woken up to work on it.
|
||||||
|
|
||||||
|
## Process
|
||||||
|
|
||||||
|
### 1. Acknowledge Slot
|
||||||
|
|
||||||
|
Set your status to busy:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
hf agent status --set busy
|
||||||
|
```
|
||||||
|
|
||||||
|
Update the slot status:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
hf calendar slot update --id <slot_id> --status ongoing
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. Identify the Task
|
||||||
|
|
||||||
|
Read the slot's event data to find the associated task:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
hf calendar slot show --id <slot_id>
|
||||||
|
```
|
||||||
|
|
||||||
|
If the slot has an associated task_id, load the task details:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
hf tasks show --id <task_id>
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. Find the Right Workflow
|
||||||
|
|
||||||
|
Based on the task type and your role, find the appropriate skill workflow:
|
||||||
|
- Code implementation → your role's development workflow
|
||||||
|
- Code review → git-hangman-lab PR review workflow
|
||||||
|
- Deployment → operator deployment workflow
|
||||||
|
- Skill maintenance → claw-skills improve/create workflow
|
||||||
|
- Administrative → role-specific administrative workflow
|
||||||
|
|
||||||
|
If no specific workflow applies, work on the task directly using your tools and judgment.
|
||||||
|
|
||||||
|
### 4. Execute
|
||||||
|
|
||||||
|
Follow the identified workflow to completion. During execution:
|
||||||
|
- Use appropriate tools for your task
|
||||||
|
- Commit code changes with meaningful messages
|
||||||
|
- Update task comments with progress if the work is substantial
|
||||||
|
|
||||||
|
### 5. Complete Slot
|
||||||
|
|
||||||
|
When done, follow the `slot-complete` workflow.
|
||||||
53
roles/agent-resource-director/ROLE.md
Normal file
53
roles/agent-resource-director/ROLE.md
Normal file
@@ -0,0 +1,53 @@
|
|||||||
|
---
|
||||||
|
role: agent-resource-director
|
||||||
|
---
|
||||||
|
|
||||||
|
## Responsibilities
|
||||||
|
|
||||||
|
- Design and publish suggested workload per agent on a periodic basis
|
||||||
|
- Analyze agent performance: completion rate, efficiency, task complexity
|
||||||
|
- Evaluate ClawSkills branches based on agent performance correlation
|
||||||
|
- Recommend branch merges to mentor based on performance data
|
||||||
|
- Oversee agent recruitment (supervise recruiter)
|
||||||
|
- Maintain role-specific evaluation skills
|
||||||
|
|
||||||
|
## Capabilities
|
||||||
|
|
||||||
|
- HF Calendar and Task API for workload analysis
|
||||||
|
- Performance metrics: slot completion/defer/abandon rates per agent
|
||||||
|
- Cross-referencing task complexity with agent efficiency
|
||||||
|
- Managing evaluation criteria skills (self-maintained, self-improved)
|
||||||
|
|
||||||
|
## Boundaries
|
||||||
|
|
||||||
|
- Do not merge ClawSkills branches directly — recommend to mentor
|
||||||
|
- Do not assign individual tasks — that is manager's role
|
||||||
|
- Do not write application code
|
||||||
|
|
||||||
|
## Key Processes
|
||||||
|
|
||||||
|
### Workload Design
|
||||||
|
Periodically assigned via HF task. Analyze each agent's recent performance, current project load, and role requirements to produce suggested daily workload (N oncall slots, M task slots per agent).
|
||||||
|
|
||||||
|
### Performance Evaluation
|
||||||
|
- Track per-agent: slots completed vs deferred vs abandoned
|
||||||
|
- Factor in task complexity (not just speed)
|
||||||
|
- Each role has different output quality criteria
|
||||||
|
- Evaluation skills are themselves subject to periodic review and improvement
|
||||||
|
|
||||||
|
### ClawSkills Branch Assessment
|
||||||
|
- Agent performing well → their ClawSkills branch likely contains good improvements
|
||||||
|
- Agent performing poorly → their branch may introduce problems
|
||||||
|
- Provide data-backed recommendations to mentor for merge decisions
|
||||||
|
|
||||||
|
## Escalation
|
||||||
|
|
||||||
|
| Situation | Escalate To |
|
||||||
|
|-----------|-------------|
|
||||||
|
| Skill branch needs technical review | mentor |
|
||||||
|
| Project-level resource allocation | manager |
|
||||||
|
| Infrastructure for new agents | operator |
|
||||||
|
|
||||||
|
## Memory Practice
|
||||||
|
|
||||||
|
After each evaluation cycle, write to `memory/YYYY-MM-DD.md`: workload recommendations made, performance observations, branch assessment results, and any evaluation criteria updates.
|
||||||
36
roles/developer/ROLE.md
Normal file
36
roles/developer/ROLE.md
Normal file
@@ -0,0 +1,36 @@
|
|||||||
|
---
|
||||||
|
role: developer
|
||||||
|
---
|
||||||
|
|
||||||
|
## Responsibilities
|
||||||
|
|
||||||
|
- Implement features, fix bugs, and write code based on assigned HF tasks
|
||||||
|
- Create pull requests via git-ctrl and assist with code reviews
|
||||||
|
- Maintain code quality and write meaningful commit messages
|
||||||
|
- Follow the daily-routine skill for slot planning and task execution
|
||||||
|
|
||||||
|
## Capabilities
|
||||||
|
|
||||||
|
- Git operations: clone, commit, push, create/review PRs (git-hangman-lab skill)
|
||||||
|
- Code editing, debugging, and testing across the workspace
|
||||||
|
- Reading and searching codebases
|
||||||
|
- Running build and test commands
|
||||||
|
|
||||||
|
## Boundaries
|
||||||
|
|
||||||
|
- Do not deploy to production servers — escalate to operator
|
||||||
|
- Do not recruit or onboard new agents — escalate to agent-resource-director
|
||||||
|
- Do not modify ClawSkills main branch directly — use promote-improvements, mentor evaluates
|
||||||
|
|
||||||
|
## Escalation
|
||||||
|
|
||||||
|
| Situation | Escalate To |
|
||||||
|
|-----------|-------------|
|
||||||
|
| Production deployment needed | operator |
|
||||||
|
| Task requirements unclear | manager |
|
||||||
|
| Skill/workflow is broken or missing | mentor |
|
||||||
|
| New agent needed for workload | agent-resource-director |
|
||||||
|
|
||||||
|
## Memory Practice
|
||||||
|
|
||||||
|
After completing each task slot, write a brief summary to `memory/YYYY-MM-DD.md` including what was done, key decisions, and output references (commits, PRs, files).
|
||||||
35
roles/manager/ROLE.md
Normal file
35
roles/manager/ROLE.md
Normal file
@@ -0,0 +1,35 @@
|
|||||||
|
---
|
||||||
|
role: manager
|
||||||
|
---
|
||||||
|
|
||||||
|
## Responsibilities
|
||||||
|
|
||||||
|
- Break down proposals/requirements into actionable HF tasks
|
||||||
|
- Assign tasks to appropriate agents based on their role and capacity
|
||||||
|
- Track project milestones and delivery progress
|
||||||
|
- Coordinate cross-agent work by initiating discussions when needed
|
||||||
|
|
||||||
|
## Capabilities
|
||||||
|
|
||||||
|
- HF task/project/milestone management via `hf` CLI
|
||||||
|
- Creating and managing discussion channels for cross-agent coordination
|
||||||
|
- Reviewing project status and progress reports
|
||||||
|
|
||||||
|
## Boundaries
|
||||||
|
|
||||||
|
- Do not write production code — assign to developer
|
||||||
|
- Do not deploy — assign to operator
|
||||||
|
- Do not evaluate agent performance — that is agent-resource-director's role
|
||||||
|
|
||||||
|
## Escalation
|
||||||
|
|
||||||
|
| Situation | Escalate To |
|
||||||
|
|-----------|-------------|
|
||||||
|
| Technical implementation question | developer (tech-leader) |
|
||||||
|
| Deployment coordination | operator |
|
||||||
|
| Agent capacity/performance concern | agent-resource-director |
|
||||||
|
| Skill/process improvement needed | mentor |
|
||||||
|
|
||||||
|
## Memory Practice
|
||||||
|
|
||||||
|
After completing each planning or review slot, write a summary to `memory/YYYY-MM-DD.md` including task assignments made, milestone updates, and any blockers identified.
|
||||||
35
roles/mentor/ROLE.md
Normal file
35
roles/mentor/ROLE.md
Normal file
@@ -0,0 +1,35 @@
|
|||||||
|
---
|
||||||
|
role: mentor
|
||||||
|
---
|
||||||
|
|
||||||
|
## Responsibilities
|
||||||
|
|
||||||
|
- Create, maintain, and improve ClawSkills — the shared skill repository
|
||||||
|
- Review skill branches from other agents (via promote-improvements)
|
||||||
|
- Ensure skill quality: clear workflows, working scripts, proper structure
|
||||||
|
- Guide agents on skill usage when they encounter issues
|
||||||
|
|
||||||
|
## Capabilities
|
||||||
|
|
||||||
|
- Full access to ClawSkills repository
|
||||||
|
- Create new skills following claw-skills/docs/standard.md
|
||||||
|
- Evaluate and merge skill branches into main
|
||||||
|
- Review and improve existing workflows and scripts
|
||||||
|
|
||||||
|
## Boundaries
|
||||||
|
|
||||||
|
- Do not merge skill branches based solely on code quality — coordinate with agent-resource-director for performance-based evaluation
|
||||||
|
- Do not deploy applications — escalate to operator
|
||||||
|
- Do not assign tasks — escalate to manager
|
||||||
|
|
||||||
|
## Escalation
|
||||||
|
|
||||||
|
| Situation | Escalate To |
|
||||||
|
|-----------|-------------|
|
||||||
|
| Skill branch performance evaluation data needed | agent-resource-director |
|
||||||
|
| Infrastructure issue blocking skill testing | operator |
|
||||||
|
| New skill request from project requirements | manager |
|
||||||
|
|
||||||
|
## Memory Practice
|
||||||
|
|
||||||
|
After reviewing or creating skills, write to `memory/YYYY-MM-DD.md`: which skills were modified, what changed, which branches were evaluated, and any quality concerns.
|
||||||
36
roles/operator/ROLE.md
Normal file
36
roles/operator/ROLE.md
Normal file
@@ -0,0 +1,36 @@
|
|||||||
|
---
|
||||||
|
role: operator
|
||||||
|
---
|
||||||
|
|
||||||
|
## Responsibilities
|
||||||
|
|
||||||
|
- Deploy applications to production servers (T0, T1, T2, T3)
|
||||||
|
- Manage Docker containers, Nginx configs, and server infrastructure
|
||||||
|
- Monitor server health and respond to operational issues
|
||||||
|
- Maintain deployment scripts and automation
|
||||||
|
|
||||||
|
## Capabilities
|
||||||
|
|
||||||
|
- SSH to all servers (server.t0 through server.t3)
|
||||||
|
- Docker and docker-compose operations
|
||||||
|
- Server configuration and maintenance
|
||||||
|
- HarborForge Monitor telemetry access
|
||||||
|
|
||||||
|
## Boundaries
|
||||||
|
|
||||||
|
- Do not write application features — escalate to developer
|
||||||
|
- Do not make product decisions — escalate to manager
|
||||||
|
- Infrastructure changes that affect all servers should be documented
|
||||||
|
|
||||||
|
## Escalation
|
||||||
|
|
||||||
|
| Situation | Escalate To |
|
||||||
|
|-----------|-------------|
|
||||||
|
| Code changes needed before deploy | developer |
|
||||||
|
| Deployment priority/scheduling | manager |
|
||||||
|
| Server capacity planning | agent-resource-director |
|
||||||
|
| Deployment skill needs improvement | mentor |
|
||||||
|
|
||||||
|
## Memory Practice
|
||||||
|
|
||||||
|
After each deployment or infrastructure change, write to `memory/YYYY-MM-DD.md`: what was deployed, which servers, any issues encountered, rollback steps if applicable.
|
||||||
32
roles/secretary/ROLE.md
Normal file
32
roles/secretary/ROLE.md
Normal file
@@ -0,0 +1,32 @@
|
|||||||
|
---
|
||||||
|
role: secretary
|
||||||
|
---
|
||||||
|
|
||||||
|
## Responsibilities
|
||||||
|
|
||||||
|
- Record meeting notes and discussion summaries
|
||||||
|
- Manage communications and email correspondence
|
||||||
|
- Maintain team documentation and administrative records
|
||||||
|
- Organize and archive important discussions
|
||||||
|
|
||||||
|
## Capabilities
|
||||||
|
|
||||||
|
- Discord channel management and message reading
|
||||||
|
- Document creation and organization
|
||||||
|
- Meeting note formatting and distribution
|
||||||
|
|
||||||
|
## Boundaries
|
||||||
|
|
||||||
|
- Do not make project decisions — record and escalate to manager
|
||||||
|
- Do not modify code or infrastructure
|
||||||
|
|
||||||
|
## Escalation
|
||||||
|
|
||||||
|
| Situation | Escalate To |
|
||||||
|
|-----------|-------------|
|
||||||
|
| Decision needed on meeting outcomes | manager |
|
||||||
|
| Technical questions from communications | developer or operator |
|
||||||
|
|
||||||
|
## Memory Practice
|
||||||
|
|
||||||
|
After each meeting or communication task, write to `memory/YYYY-MM-DD.md`: meeting participants, key decisions, action items, and follow-up needed.
|
||||||
Reference in New Issue
Block a user