dismech: Skill for Claude Code

Project Management (projman)

Overview

Manage markdown-based project files in projects/ with optional sync to GitHub Projects. Markdown files are the source of truth; GitHub Projects provides visibility/collaboration.

Project File Structure

Projects live in projects/ as either:

• PROJECT_NAME.md - single file project
• PROJECT_NAME/ - folder with multiple materials

Standard Sections

# Project Title

## Overview
[Project description, goals, selection criteria]

## Items to Process
| Item | Field1 | Field2 | Status |
|------|--------|--------|--------|
| Item A | value | value | [ ] |
| Item B | value | value | [x] |

---
# STATUS
## Tier/Category 1 (N/M) ✓
- [x] Completed item - Date, notes
- [ ] Pending item

## Tier/Category 2 (N/M)
- [ ] Item

# NOTES
## YYYY-MM-DD
[Session notes - add new entries at top]

Core Workflows

1. View Project Status

# List all projects
ls projects/

# Quick status - count checkboxes
grep -c "^\- \[x\]" projects/CANCER.md    # completed
grep -c "^\- \[ \]" projects/CANCER.md    # pending

2. Pick Up Next Item

Read project file → find first unchecked item in priority order → work on it.

# Parse checkboxes from markdown
import re
with open("projects/CANCER.md") as f:
    content = f.read()
# Find unchecked items: - [ ] Item name
pending = re.findall(r'- \[ \] (.+)', content)
next_item = pending[0] if pending else None

3. Update Status After Work

After completing an item:

1. Change - [ ] to - [x]
2. Add date/compliance info: - [x] Item Name - Created 2026-01-30, 55% compliance
3. Add session notes under # NOTES with today's date

4. Add Session Notes

Always add notes incrementally:

# NOTES

## 2026-01-30
[Today's work - add at TOP]
- Completed X, Y, Z
- Key findings: ...

## 2026-01-29
[Previous session - don't edit unless continuing]

Get today's date: date +%Y-%m-%d

GitHub Project Sync

Setup (One-Time)

# Check auth has project scope
gh auth status  # should show 'project' in scopes

# If missing:
gh auth refresh -s project

# Create a new GitHub Project for a markdown project
gh project create --owner @me --title "dismech: CANCER Curation"
# Note the project number returned (e.g., 4)