items

Solid

The credo work-item model, where the FOLDER an item file lives in is the single source of truth for its status, gated by a hard Definition of Done. Use whenever you create, update, or track a work item; whenever you decide whether something is "done" and may move to 2_done/; whenever you move an item between status folders (clarify, go, done, archived, parked); whenever new code might be unwired; or when someone asks where a task stands. This is the credo task system: .credo/items/ replaces ad-hoc task lists. Applies inside subagents too - if you build or complete work, record and gate it as an item.

AI & Automation 13 stars 3 forks Updated 5 days ago MIT

Install

View on GitHub

Quality Score: 80/100

Stars 20%
38
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# items - the credo work-item model A work item is a single Markdown file under `.credo/items/`. The **folder the file lives in is the only source of truth for its status**. There is no status field, no marker, no task-tracker entry - an item changes status by physically moving between folders. This is deliberate anti-drift: multiple status sources drift out of sync, one physical location cannot. `.credo/items/` IS the task system; do not mirror items into a separate task list. > **Task backend.** If the task backend is `gsd` (set in `.credo/config` as `task_backend`, or via the `CREDO_TASK_BACKEND` env override; resolve with `credo-config.sh backend`), the credo item system is inactive - GSD's > phases are the task system for this project. Do NOT create or move `.credo/items/`; use > GSD's workflow instead. This skill applies only when the backend is `credo` (the default) > or `none`. ## Status = folder (the only truth) The folder tree (created by `credo-init`) and what each folder means: ``` .credo/items/ 1_todo/ 1_clarify/ open questions - needs the user, NOT buildable yet 2_go/ clarified and approved - buildable (go-gate: only 2_go is buildable) 2_done/ Definition of Done met (agent and/or user), gate passed 3_verified/ USER-ONLY - human-in-the-loop confirmation (an agent never places here) 4_archived/ abandoned / deprecated / rejected parked/ hold/ blocked by an external dependency future/ del...

Details

Author
Marcel-Bich
Repository
Marcel-Bich/marcel-bich-claude-marketplace
Created
6 months ago
Last Updated
5 days ago
Language
Shell
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category