Files
steev/README.md
T

47 lines
3.3 KiB
Markdown

# Steev — Personal-Agent Profile Distribution
`personal-agent` is the canonical profile identity. Steev is the user-facing display name and current distribution alias.
JP's personal assistant / chief of staff. Daily briefing, inbox triage, comms in JP's voice, business delegation to CEO. French/English bilingual.
- **Identity:** [`AGENT.md`](AGENT.md) — role, mission, boundaries.
- **Profile surface contract:** [`docs/contracts/personal-agent-profile-surface-contract.json`](docs/contracts/personal-agent-profile-surface-contract.json) — canonical surfaces, effects, memory route, and proof policy.
- **BlueBubbles binding:** [`docs/contracts/personal-agent-bluebubbles-binding.json`](docs/contracts/personal-agent-bluebubbles-binding.json) — `imessage.read` binds to the existing BlueBubbles package without a duplicate connector.
- **Proton/rclone package candidate:** [`docs/contracts/personal-agent-proton-rclone-package.json`](docs/contracts/personal-agent-proton-rclone-package.json) — Mail, Calendar, Contacts, and Drive surfaces with redacted runtime inventory and no readiness overclaim.
- **Secondbrain proposal route:** [`docs/contracts/personal-agent-secondbrain-proposal-route.json`](docs/contracts/personal-agent-secondbrain-proposal-route.json) — proposal-only personal memory intake; durable apply remains owned by Secondbrain.
- **Conductor/Curator service handoff:** [`docs/contracts/personal-agent-conductor-curator-service-handoff.json`](docs/contracts/personal-agent-conductor-curator-service-handoff.json) — redacted service map for future route selection and hygiene review pickup.
- **Runtime readiness snapshot:** [`docs/contracts/personal-agent-runtime-readiness-snapshot.json`](docs/contracts/personal-agent-runtime-readiness-snapshot.json) — redacted per-surface runtime state and gaps; aggregate readiness remains degraded.
- **Desktop exposure contract:** [`docs/contracts/personal-agent-desktop-exposure-contract.json`](docs/contracts/personal-agent-desktop-exposure-contract.json) — adapter-facing state rows for Desktop/Dashboard display; no UI wiring from this route.
- **Historical Steev reference redirect:** [`docs/STEEV-MASTER.md`](docs/STEEV-MASTER.md).
## Structure
```
steev/
├── AGENT.md identity: role, mission, boundaries
├── manifest.yaml machine-readable install contract
├── install.sh idempotent wiring → ~/.hermes/steev symlink
├── schema.sql steev.db schema (never committed)
├── skills/
│ └── steev-agent/ orchestrator: briefing, triage, drafting, delegation
└── docs/
└── STEEV-MASTER.md source of truth
```
## Install
```bash
git clone https://git.openharbor.io/hermes/steev && cd steev
./install.sh # symlinks repo → ~/.hermes/steev (idempotent)
hermes -p steev skills list | grep steev-agent
```
Default install **symlinks** `~/.hermes/steev` → this repo. Use `./install.sh --copy` on machines that shouldn't run the checkout as the live dir.
## Key invariants
- JP's voice ≠ Plan B brand voice (add `skills/steev-agent/jp-voice.md` to scope it)
- Business tasks → CEO via kanban, never execute directly
- No Plan B marketing credentials (WooCommerce, Mailchimp, Meta, etc.)
- Steev drafts, JP sends — no autonomous message delivery