Compare commits
No commits in common. "627a4d7995c8b71c7305572735547b0856deab78" and "6a72faf83b3aeb35ee44da51898fe8cbce6f5002" have entirely different histories.
627a4d7995
...
6a72faf83b
7 changed files with 8 additions and 21 deletions
|
|
@ -1 +0,0 @@
|
|||
6a72faf83b3aeb35ee44da51898fe8cbce6f5002
|
||||
12
AGENTS.md
12
AGENTS.md
|
|
@ -24,22 +24,12 @@ Before making changes, read in this order:
|
|||
|
||||
- `server/`: Express REST API and orchestration services
|
||||
- `ui/`: React + Vite board UI
|
||||
- `cli/`: CLI package (`paperclipai` command)
|
||||
- `packages/db/`: Drizzle schema, migrations, DB clients
|
||||
- `packages/shared/`: shared types, constants, validators, API path constants
|
||||
- `packages/adapters/`: agent adapter implementations (Claude, Codex, Cursor, etc.)
|
||||
- `packages/adapter-utils/`: shared adapter utilities
|
||||
- `packages/plugins/`: plugin system packages
|
||||
- `skills/`: agent skills (Paperclip skill, company skills)
|
||||
- `doc/`: operational and product docs
|
||||
- `docs/`: Mintlify documentation site
|
||||
- `tests/`: end-to-end and release smoke tests
|
||||
- `scripts/`: build, dev, and release scripts
|
||||
- `evals/`: promptfoo evaluation suites
|
||||
- `releases/`: release notes
|
||||
- `patches/`: pnpm dependency patches
|
||||
- `docker/`: Docker configuration
|
||||
- `report/`: generated analysis and audit reports
|
||||
|
||||
## 4. Dev Setup (Auto DB)
|
||||
|
||||
|
|
@ -65,7 +55,7 @@ curl http://localhost:3100/api/companies
|
|||
Reset local dev DB:
|
||||
|
||||
```sh
|
||||
rm -rf ~/.paperclip/instances/default/db
|
||||
rm -rf data/pglite
|
||||
pnpm dev
|
||||
```
|
||||
|
||||
|
|
|
|||
|
|
@ -11,8 +11,8 @@ We really appreciate both small fixes and thoughtful larger changes.
|
|||
- Pick **one** clear thing to fix/improve
|
||||
- Touch the **smallest possible number of files**
|
||||
- Make sure the change is very targeted and easy to review
|
||||
- All automated checks pass (CI typecheck, tests, build)
|
||||
- No new test failures
|
||||
- All automated checks pass (including Greptile comments)
|
||||
- No new lint/test failures
|
||||
|
||||
These almost always get merged quickly when they're clean.
|
||||
|
||||
|
|
@ -27,7 +27,7 @@ These almost always get merged quickly when they're clean.
|
|||
- Clear description of what & why
|
||||
- Proof it works (manual testing notes)
|
||||
- All tests passing
|
||||
- All PR review comments addressed
|
||||
- All Greptile + other PR comments addressed
|
||||
|
||||
PRs that follow this path are **much** more likely to be accepted, even when they're large.
|
||||
|
||||
|
|
|
|||
|
|
@ -244,7 +244,7 @@ See [doc/DEVELOPING.md](doc/DEVELOPING.md) for the full development guide.
|
|||
- ⚪ Artifacts & Deployments
|
||||
- ⚪ CEO Chat
|
||||
- ⚪ MAXIMIZER MODE
|
||||
- ✅ Multiple Human Users
|
||||
- ⚪ Multiple Human Users
|
||||
- ⚪ Cloud / Sandbox agents (e.g. Cursor / e2b agents)
|
||||
- ⚪ Cloud deployments
|
||||
- ⚪ Desktop App
|
||||
|
|
|
|||
|
|
@ -54,7 +54,7 @@ I am researching the Facebook ads Granola uses (current task)
|
|||
|
||||
Tasks have parentage. Every task exists in service of a parent task, all the way up to the company goal. This is what keeps autonomous agents aligned — they can always answer "why am I doing this?"
|
||||
|
||||
Tasks carry statuses (backlog, todo, in_progress, in_review, done, blocked, cancelled), priorities, project and goal associations, billing codes for cross-team cost attribution, and execution workspace context. See [SPEC.md](./SPEC.md) for the full task model.
|
||||
More detailed task structure TBD.
|
||||
|
||||
## Principles
|
||||
|
||||
|
|
|
|||
|
|
@ -196,7 +196,6 @@ Agent configuration includes an **adapter** that defines how Paperclip invokes t
|
|||
| `codex_local` | Local Codex process | Codex CLI heartbeat worker |
|
||||
| `opencode_local` | Local OpenCode process | OpenCode heartbeat worker |
|
||||
| `pi_local` | Local Pi process | Pi CLI heartbeat worker |
|
||||
| `gemini_local` | Local Gemini process | Gemini CLI heartbeat worker |
|
||||
| `cursor` | Cursor API/CLI bridge | Cursor-integrated heartbeat worker |
|
||||
| `openclaw_gateway` | OpenClaw gateway API | Managed OpenClaw agent via gateway |
|
||||
| `hermes_local` | Local Hermes process | Hermes agent heartbeat worker |
|
||||
|
|
@ -435,7 +434,7 @@ The core Paperclip system must be extensible. Features like knowledge bases, ext
|
|||
- Well-defined API boundaries that plugins can hook into
|
||||
- Event system or hooks for reacting to task/Agent lifecycle events
|
||||
- **Agent Adapter plugins** — new Adapter types can be registered via the plugin system
|
||||
- Plugin-registrable UI components (toolbar buttons, pages, slots)
|
||||
- Plugin-registrable UI components (future)
|
||||
|
||||
The plugin framework has shipped. Plugins can register new adapter types, hook into lifecycle events, and contribute UI components (e.g. global toolbar buttons). A plugin SDK and CLI commands (`paperclipai plugin`) are available for authoring and installing plugins.
|
||||
|
||||
|
|
|
|||
|
|
@ -37,7 +37,6 @@ Built-in adapters:
|
|||
- `claude_local`: runs your local `claude` CLI
|
||||
- `codex_local`: runs your local `codex` CLI
|
||||
- `opencode_local`: runs your local `opencode` CLI
|
||||
- `gemini_local`: runs your local Gemini CLI
|
||||
- `hermes_local`: runs your local `hermes` CLI
|
||||
- `cursor`: runs Cursor in background mode
|
||||
- `pi_local`: runs an embedded Pi agent locally
|
||||
|
|
@ -45,7 +44,7 @@ Built-in adapters:
|
|||
- `process`: generic shell command adapter
|
||||
- `http`: calls an external HTTP endpoint
|
||||
|
||||
For local CLI adapters (`claude_local`, `codex_local`, `opencode_local`, `gemini_local`, `hermes_local`), Paperclip assumes the CLI is already installed and authenticated on the host machine.
|
||||
For local CLI adapters (`claude_local`, `codex_local`, `opencode_local`, `hermes_local`), Paperclip assumes the CLI is already installed and authenticated on the host machine.
|
||||
|
||||
## 3.2 Runtime behavior
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue