Worklog Spec

Current — this is the living version. Historical snapshots are linked from Index-Releases.

Worklog Spec

This repository uses WikiTicket SDD (worklog) for visible WIP: plans, event-log tickets, generated roadmap, and wiki publish.

Canonical specification

The full worklog specification lives upstream:

• Repo: SpillwaveSolutions/wiki_ticket_sdd
• Spec: docs/worklog-spec.md in that repository
• Plugin install: worklog@worklog-marketplace from the upstream marketplace

This page is a project-local pointer, not a fork of the full spec.

How okf-plugin uses worklog

Artifact	Path
Event log	.work/todo.jsonl, .work/done.jsonl
Config	.work/config.yml (GitHub Issues + github-wiki)
Roadmap	docs/roadmap.md (generated)
Plans	docs/plans/
CLI	bin/worklog
Publish ledger	.work/published.json

Day-to-day

bin/worklog list
bin/worklog add "Title" --level task --kind feature --body "what and why"
bin/worklog roadmap-render
bin/worklog ia-index

Commits should reference a worklog ULID or #issue. Prefer feature branches (hooks reject direct commits on main).

Bridge to OKF

TicketLink concepts map worklog ULIDs / GitHub issues into the knowledge graph — see CLI-Reference (okf-ticket-link.py) and skill okf-author references.

See also

• Roadmap
• Index-Traceability
• Upstream graph engineering note