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