Description

Build a Node.js static site generator that reads the workforce git board (board/ directory) and outputs a dark-mode Trello-style kanban web UI.

The generator should:

1. Parse all task files in board/{backlog,in-progress,in-review,done,blocked}/ — YAML frontmatter + markdown body
2. Parse all project files in board/projects/ for project metadata
3. Generate static HTML output to kanban/dist/

The UI should:

1. Display a classic kanban board with 5 columns: Backlog, In Progress, In Review, Done, Blocked
2. Dark mode styling
3. Each task rendered as a card showing: title, assignee, project badge, priority (1-5), created/updated timestamps
4. Clicking a card expands it to show the full rendered markdown content (description, acceptance criteria, context, notes, decisions)
5. Generate one kanban page per project (e.g., dist/infra/index.html, dist/wildus/index.html) plus one “all projects” admin page at dist/index.html
6. Responsive — usable on mobile

Acceptance Criteria

• [ ] node kanban/generate.js reads board/ and outputs static HTML to kanban/dist/
• [ ] All 5 column states rendered as kanban columns
• [ ] Task cards display title, assignee, project, priority, timestamps
• [ ] Card click expands to show full rendered markdown
• [ ] Per-project pages generated at dist/<project-id>/index.html
• [ ] Admin “all projects” page at dist/index.html
• [ ] Dark mode styling, clean Trello-style layout
• [ ] Works with current board contents (6 existing tasks across 3 projects)
• [ ] No frameworks — vanilla HTML/CSS/JS plus a markdown parsing library
• [ ] package.json in kanban/ with dependencies and a build script

Context

• Repo: git@github.com:qoyn-ai/workforce.git
• Board spec: board/README.md
• Task file format: YAML frontmatter (id, project, title, assigned, thinking, escalation, priority, tags, created, updated) + markdown sections (Description, Acceptance Criteria, Context, Dependencies, Notes, Decisions)
• Project file format: YAML frontmatter (id, name, org, repos) in board/projects/*.md
• Board columns map to directories: backlog/, in-progress/, in-review/, done/, blocked/
• See existing task files for examples of the format

Dependencies

None

Notes

• 2026-03-10 17:11 America/Los_Angeles — Built kanban/ static generator with gray-matter + markdown-it, plus package.json/package-lock.json and npm run build entrypoint.
• 2026-03-10 17:11 America/Los_Angeles — Generator now reads all board column task files and project metadata, then writes kanban/dist/index.html, per-project pages under kanban/dist/<project>/index.html, and shared styles.css/app.js assets.
• 2026-03-10 17:11 America/Los_Angeles — Verified build locally with current board contents: cd kanban && npm run build produced 8 task cards across 4 project pages with dark-mode responsive layout and expandable markdown card bodies.
• 2025-07-14 — Reviewed and approved. All acceptance criteria met. Deployed to Cloudflare Pages with git integration, custom domain, and Cloudflare Access authentication.

Decisions

Description

Create a GitHub Actions workflow that automatically builds the kanban static site and deploys it to Cloudflare Pages whenever the board changes.

Acceptance Criteria

• [ ] Workflow file at .github/workflows/deploy-kanban.yml
• [ ] Triggers on pushes to main that touch board/** or kanban/**
• [ ] Runs npm ci in kanban/ directory, then npm run build
• [ ] Deploys kanban/dist/ to Cloudflare Pages using cloudflare/wrangler-action
• [ ] Uses repository secrets: CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID
• [ ] Workflow succeeds with current board contents

Context

• Repo: git@github.com:qoyn-ai/workforce.git
• Generator from kanban-001 outputs to kanban/dist/
• Cloudflare Pages project name and secrets will be configured manually (separate task)
• Reference: https://developers.cloudflare.com/pages/how-to/use-direct-upload-with-continuous-integration/#github-actions

Dependencies

• kanban-001 (static generator must exist first)

Notes

• 2026-03-10 17:00 America/Los_Angeles — Left in backlog. Dependency kanban-001 is not complete yet, and CrankyCrab already has one active in-progress task.
• 2026-03-10 17:18 America/Los_Angeles — Added .github/workflows/deploy-kanban.yml to build kanban/ on pushes touching board/** or kanban/** and deploy kanban/dist/ via cloudflare/wrangler-action.
• 2026-03-10 17:19 America/Los_Angeles — Validated the current generator locally with npm ci && npm run build in kanban/ (Generated 8 tasks across 4 projects into kanban/dist). Workflow expects repository variable CLOUDFLARE_PAGES_PROJECT_NAME plus secrets CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID.
• 2025-07-14 — CANCELLED. Switching to Cloudflare git integration instead of GitHub Action + direct upload. Workflow file removed. Deployment will be handled natively by Cloudflare Pages.

Decisions