Ty
69b67498ff
Replace stale scaffold-only status with install progress, actor split, and design vs docs vs skills maps so operators can follow the product narrative.
57 lines
2.6 KiB
Markdown
57 lines
2.6 KiB
Markdown
# Skills
|
|
|
|
Product behavior: deterministic scripts, fixtures, and SKILL.md contracts.
|
|
|
|
See use-case catalog: [design/use-cases.md](../design/use-cases.md).
|
|
|
|
---
|
|
|
|
## How skills fit the flow
|
|
|
|
```
|
|
design/use-cases.md skills/<skill>/ skills/_lib/
|
|
(use-case spec) (SKILL.md + scripts/) (shared providers)
|
|
│ │ │
|
|
├─ A1 daily-board ├─ SKILL.md ├─ domain.py
|
|
├─ B1 books-snapshot ├─ scripts/*.py ├─ board_builder.py
|
|
├─ ... └─ fixtures/ └─ providers/
|
|
│ (scheduling, books, mcp)
|
|
```
|
|
|
|
Each skill directory maps to one or more use cases. The SKILL.md defines the contract (inputs, outputs, constraints). Scripts implement deterministic logic. Providers fetch data from fixtures (now) or live SaaS (later via MCP/REST).
|
|
|
|
---
|
|
|
|
## Status
|
|
|
|
| Directory | Status |
|
|
|-----------|--------|
|
|
| `daily-board/` | ✅ Implemented — fixtures-only, with `build_board.py` script |
|
|
| `_lib/lumina_skills/` | ✅ Implemented — domain models, board builder, fixture providers |
|
|
| `availability/` | Scaffold — SKILL.md only |
|
|
| `client-card/` | Scaffold — SKILL.md only |
|
|
| `service-menu/` | Scaffold — SKILL.md only |
|
|
| `retail-stock/` | Scaffold — SKILL.md only |
|
|
| `books-snapshot/` | Scaffold — SKILL.md only |
|
|
| `ar-open-invoices/` | Scaffold — SKILL.md only |
|
|
| `ap-bills-due/` | Scaffold — SKILL.md only |
|
|
| `vendor-spend/` | Scaffold — SKILL.md only |
|
|
| `vendor-inbox/` | Scaffold — SKILL.md only |
|
|
| `draft-invoice/` | Scaffold — SKILL.md only |
|
|
| `draft-client-message/` | Scaffold — SKILL.md only |
|
|
| `social-draft/` | Scaffold — SKILL.md only |
|
|
| `weekly-digest/` | Scaffold — SKILL.md only |
|
|
| `remember-forget/` | Scaffold — SKILL.md only |
|
|
| `setup-education/` | Scaffold — SKILL.md only (Task 5 next) |
|
|
| `publish-boundary-test/` | Scaffold — SKILL.md only |
|
|
|
|
---
|
|
|
|
## Rules (from design)
|
|
|
|
- **Draft-first outbound.** Skills draft messages; the owner sends. No silent send, publish, or pay.
|
|
- **Deterministic facts from tools.** Code computes appointments, gaps, thresholds, JSON→domain objects. The model ranks and words.
|
|
- **Fixture data is labeled.** Output always marks `📋 FIXTURE DATA` so the owner never sees silent fake live data.
|
|
- **Refuse pay / silent send / publish.** Enforced by OpenShell policy + skill hard-fail + model refusal.
|
|
- **Det vs inference boundary:** [design/det-vs-inf.md](../design/det-vs-inf.md)
|