ake/paperclip
1
0
Fork 0
mirror of https://github.com/alkimake/paperclip.git synced 2026-06-15 18:30:39 +09:00
Code Issues Projects Releases Packages Wiki Activity

docs: sync docs and skills updates from backup branch

Browse source
This commit is contained in:
Dotta 2026-03-02 16:44:10 -06:00
parent 8ee063c4e5
commit cabd16bc70
60 changed files with 209 additions and 246 deletions
Download patch file Download diff file Expand all files Collapse all files

2
docs/guides/agent-developer/comments-and-communication.md
View file

@ -3,8 +3,6 @@ title: Comments and Communication
summary: How agents communicate via issues
---
# Comments and Communication
Comments on issues are the primary communication channel between agents. Every status update, question, finding, and handoff happens through comments.
## Posting Comments

2
docs/guides/agent-developer/cost-reporting.md
View file

@ -3,8 +3,6 @@ title: Cost Reporting
summary: How agents report token costs
---
# Cost Reporting
Agents report their token usage and costs back to Paperclip so the system can track spending and enforce budgets.
## How It Works

2
docs/guides/agent-developer/handling-approvals.md
View file

@ -3,8 +3,6 @@ title: Handling Approvals
summary: Agent-side approval request and response
---
# Handling Approvals
Agents interact with the approval system in two ways: requesting approvals and responding to approval resolutions.
## Requesting a Hire

2
docs/guides/agent-developer/heartbeat-protocol.md
View file

@ -3,8 +3,6 @@ title: Heartbeat Protocol
summary: Step-by-step heartbeat procedure for agents
---
# Heartbeat Protocol
Every agent follows the same heartbeat procedure on each wake. This is the core contract between agents and Paperclip.
## The Steps

2
docs/guides/agent-developer/how-agents-work.md
View file

@ -3,8 +3,6 @@ title: How Agents Work
summary: Agent lifecycle, execution model, and status
---
# How Agents Work
Agents in Paperclip are AI employees that wake up, do work, and go back to sleep. They don't run continuously — they execute in short bursts called heartbeats.
## Execution Model

2
docs/guides/agent-developer/task-workflow.md
View file

@ -3,8 +3,6 @@ title: Task Workflow
summary: Checkout, work, update, and delegate patterns
---
# Task Workflow
This guide covers the standard patterns for how agents work on tasks.
## Checkout Pattern

2
docs/guides/agent-developer/writing-a-skill.md
View file

@ -3,8 +3,6 @@ title: Writing a Skill
summary: SKILL.md format and best practices
---
# Writing a Skill
Skills are reusable instructions that agents can invoke during their heartbeats. They're markdown files that teach agents how to perform specific tasks.
## Skill Structure