Skip to content

a5c-ai/babysitter / library/methodologies/gsd/skills/state-management

state-management

Verified

FileKindSize
README.mdmarkdown1.8 KB
SKILL.mdskill md6.9 KB
# state-management

STATE.md CRUD operations and cross-session memory persistence for GSD projects.

## Quick Start

STATE.md is the living memory of your GSD project. This skill reads, writes, and updates it.

### Read Current State

```bash
cat .planning/STATE.md
```

### Update Current Task

Edit the "Current Work" section to reflect what is being worked on now.

### Add a Blocker

Append to the Blockers section:
```markdown
- [ ] [HIGH] Description of blocker (@owner, 2026-03-02)
```

### Resolve a Blocker

Change `[ ]` to `[x]` and append resolution date.

### Log a Decision

Append a row to the Decisions table:
```markdown
| 2026-03-02 | Decision text | Rationale text |
```

## Examples

### Fresh State After New Project

```markdown
---
last_updated: 2026-03-02T14:30:00Z
session_count: 1
current_milestone: v1.0
---

# Project State

## Current Work
- **Phase**: none
- **Task**: none
- **Status**: initialized

## Completed Phases
(none yet)

## Blockers
(none)

## Decisions
| Date | Decision | Rationale |
|------|----------|-----------|

## Quick Tasks
| # | Task | Status | Date |
|---|------|--------|------|
```

### Mid-Project State

The state fills in as phases are planned, executed, and verified.

## Troubleshooting

### STATE.md is missing
- Run gsd-tools initialization to create from template
- Or create manually following the format above

### Edits failing (non-unique match)
- STATE.md edits use exact string matching
- Provide more surrounding context in the edit operation
- Avoid duplicate text in different sections

### Session count not incrementing
- Session count updates on first read per session
- Check frontmatter YAML is valid

### Blocker not showing as resolved
- Ensure the checkbox syntax changed from `- [ ]` to `- [x]`
- Append the resolution date after the blocker text
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall