pm-tasks-core

Files (78)

• CHANGELOG.md
• LICENSE
• README.md
• SKILL.md
• core.md · anti-patterns/
• README.es-ES.md · docs/i18n/
• README.pt-BR.md · docs/i18n/
• en-US.json · i18n/
• es-ES.json · i18n/
• pt-BR.json · i18n/
• package.json
• agent-agnostic-lint.md · references/
• attribution.md · references/
• audit-log-format.md · references/
• autonomous-mode.md · references/
• contract.md · references/
• crud-vocabulary.md · references/
• doctor.md · references/
• generic-card.md · references/
• init-ux.md · references/
• lifecycle-fidelity.md · references/
• plan-execution.md · references/
• adapter-manifest.schema.json · schemas/
• attribution.schema.json · schemas/
• rotate-audit.mjs · scripts/
• audit.ts · src/
• doctor.ts · src/bin/
• doctor.ts · src/
• estimation.ts · src/
• registry.ts · src/i18n/
• index.ts · src/
• init-lib.ts · src/
• discover.ts · src/plan-execution/
• hooks.ts · src/plan-execution/
• index.ts · src/plan-execution/
• require-config.ts · src/plan-execution/
• checklist-check.ts · src/runtime/handlers/
• task-assignee-add.ts · src/runtime/handlers/
• task-close.ts · src/runtime/handlers/
• task-comment-add.ts · src/runtime/handlers/
• task-create.ts · src/runtime/handlers/
• task-due-date-set.ts · src/runtime/handlers/
• task-estimate-set.ts · src/runtime/handlers/
• task-move.ts · src/runtime/handlers/
• task-parent-set.ts · src/runtime/handlers/
• task-sprint-set.ts · src/runtime/handlers/
• index.ts · src/runtime/
• session.ts · src/runtime/
• transport.ts · src/runtime/
• audit.test.ts · tests/
• doctor.test.ts · tests/
• estimation.test.ts · tests/
• attribution-keys.test.ts · tests/i18n/
• en-US.test.ts · tests/i18n/
• parity.test.ts · tests/i18n/
• registry.test.ts · tests/i18n/
• init-lib-validate-config.test.ts · tests/
• init-lib.test.ts · tests/
• discover.test.ts · tests/plan-execution/
• hooks.test.ts · tests/plan-execution/
• …and 18 more

SKILL.md (first lines)

# 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`](references/contract.md).

## Phases

| Phase | Purpose                                                      | Reference                                                  |
| ----- | ------------------------------------------------------------ | ---------------------------------------------------------- |
| 1     | Identify the input (plan file vs inline paste vs implicit)   | [`references/contract.md`](references/contract.md) § 1     |
| 2     | Extract sections by intent (goal, prereqs, tasks, done-when) | [`references/contract.md`](references/contract.md) § 2     |
| 2.5   | Anti-patterns gate                                           | [`anti-patterns/core.md`](anti-patterns/core.md)           |
| 3     | Build the generic card                                       | [`references/generic-card.md`](references/generic-card.md) |

Adapters then execute Phases 4+ per their own SKILL.md.

## CRUD vocabulary (verbs adapters implement)

See [`references/crud-vocabulary.md`](references/crud-vocabulary.md). Ten verbs: `task.create`, `checklist.check`, `task.close`, `task.due-date.set`, `task.assignee.add`, `task.comment.add`, `task.move`, `task.parent.set` (adapter-optional), `task.estimate.set` (adapter-optional), `task.sprint.set` (adapter-optional; Linear first supporter). All idempotent (with `clientToken` rules for non-natural cases).

## Autonomous mode

See [`references/autonomous-mode.md`](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. Agent-authored copy (commits, PRs, comments) follows the workspace narration language — see [Narration language](#narration-language).

## Narration language

**Narration language.** When `.<tool>.json` sets `locale`, all agent-authored narration — comments the agent writes, autonomous-mode commit and PR copy, code comments, and audit/CLI free-text — MUST be in that locale's language. The **plan's** language still governs **task content** (title, description, checklist items); these are separate concerns. If `locale` is unset, `pm-tasks-core-doctor` (`C-LANG-1`) warns and narration defaults to English.

## 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`](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`](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`](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.

From llodev/skills, MIT.

More from llodev/skills