pm-tasks-core
Shared core for all pm-tasks-<tool> adapters. Defines the extraction phases, the generic-card structure, the CRUD vocabulary, the autonomous-mode contract, the configuration lookup rules, and the audit-log format. Adapters reference this skill by path — no formal dependency mechanism in the spec.
Routing
Adapters invoke this skill BEFORE applying their tool-specific formatting. The exact pointer is documented in references/contract.md.
Phases
| Phase | Purpose | Reference |
|---|---|---|
| 1 | Identify the input (plan file vs inline paste vs implicit) | references/contract.md § 1 |
| 2 | Extract sections by intent (goal, prereqs, tasks, done-when) | references/contract.md § 2 |
| 2.5 | Anti-patterns gate | anti-patterns/core.md |
| 3 | Build the generic card | references/generic-card.md |
Adapters then execute Phases 4+ per their own SKILL.md.
CRUD vocabulary (verbs adapters implement)
See references/crud-vocabulary.md. Six verbs, all idempotent (with clientToken rules for non-natural cases).
Autonomous mode
See references/autonomous-mode.md. Activated only by sentinel [autonomous] / --auto / env LLODEV_PM_TASKS_AUTONOMOUS=1. Requires explicit allowlist + scope + rate limit in the tool's config. Never inferred.
Configuration
Lookup order: <git-root>/.<tool>.json → ~/.config/llodev/pm-tasks/<tool>.json → abort. Secrets NEVER in JSON (env vars / OS keychain only).
Audit log
Append-only JSONL at ~/.local/share/llodev/pm-tasks/<tool>/audit.log. Schema in references/audit-log-format.md. Doubles as the lookup index for <task-ref> resolution.
Init helper
Adapters expose npx @llodev/pm-tasks-<tool> init. Shared UX in references/init-ux.md. Implementation library at @llodev/pm-tasks-core/init-lib (TypeScript source under ./src/init-lib.ts; compiled to ./dist/init-lib.js).
Health check (doctor)
pm-tasks-core-doctor validates a workspace config, autonomous allowlist, audit writability, and network reach. Check matrix and exit codes in references/doctor.md — pm-tasks-core-doctor check catalog + exit codes.
Standalone fallback
This skill is not useful without an adapter. If activated alone, tell the user to install at least one pm-tasks-<tool> package.