From 5094aa64ddf87263f5b1da29fda30a118fc69b68 Mon Sep 17 00:00:00 2001
From: Thanan Traiongthawon <95660+nullcoder@users.noreply.github.com>
Date: Thu, 5 Jun 2025 00:59:09 -0700
Subject: [PATCH] docs: add project board status management guide and update
 TODO progress
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

This commit adds detailed instructions for managing GitHub project board
statuses using the GitHub CLI, including the specific field and option IDs
needed. It also marks the Next.js initialization task as completed in
TODO.md, reflecting the recent merge of PR #14.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
---
 CLAUDE.md    | 62 +++++++++++++++++++++++++++++++++++++++++++++++-----
 docs/TODO.md |  2 +-
 2 files changed, 57 insertions(+), 7 deletions(-)

diff --git a/CLAUDE.md b/CLAUDE.md
index 7686189..83fa1ec 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -92,14 +92,18 @@ For detailed architecture, API specs, and data models, refer to `docs/SPEC.md`.
 - Check off completed tasks in `docs/TODO.md`
 - Update issue status labels as work progresses
 - Close issues only after PR is merged
+- **IMPORTANT**: Update project board status, not just labels (see below)
 
 ### Development Workflow
 1. Pick an issue from the project board
-2. Create feature branch: `git checkout -b feat/issue-description`
-3. Make changes following the issue requirements
-4. Create PR and link to issue with "Closes #XX"
-5. Add PR to project board
-6. Request review and address feedback
+2. Update issue status to "In Progress" in project board
+3. Create feature branch: `git checkout -b feat/issue-description`
+4. Make changes following the issue requirements
+5. Create PR and link to issue with "Closes #XX"
+6. Add PR to project board with "In Progress" status
+7. Add `needs review` label to PR
+8. Request review and address feedback
+9. After merge: Update both issue and PR to "Done" in project board
 
 ## Best Practices
 
@@ -134,4 +138,50 @@ For detailed architecture, API specs, and data models, refer to `docs/SPEC.md`.
 - Write tests for critical paths (encryption, binary format)
 - Test edge cases and error scenarios
 - Verify edge runtime compatibility
-- Run tests before creating PRs
\ No newline at end of file
+- Run tests before creating PRs
+
+## Project Board Status Management
+
+### Updating Status in GitHub Projects
+
+The project board uses these status values:
+- **Todo** (ID: `f75ad846`)
+- **In Progress** (ID: `47fc9ee4`) 
+- **Done** (ID: `98236657`)
+
+To update status using GitHub CLI:
+
+```bash
+# Get item IDs for issues/PRs
+gh api graphql -f query='
+{
+  user(login: "nullcoder") {
+    projectV2(number: 1) {
+      items(first: 20) {
+        nodes {
+          id
+          content {
+            ... on Issue { number title }
+            ... on PullRequest { number title }
+          }
+        }
+      }
+    }
+  }
+}'
+
+# Update to "In Progress"
+gh project item-edit --project-id PVT_kwHOAAF1rM4A6v2O --id [ITEM_ID] \
+  --field-id PVTSSF_lAHOAAF1rM4A6v2OzgvQDY4 --single-select-option-id 47fc9ee4
+
+# Update to "Done"
+gh project item-edit --project-id PVT_kwHOAAF1rM4A6v2O --id [ITEM_ID] \
+  --field-id PVTSSF_lAHOAAF1rM4A6v2OzgvQDY4 --single-select-option-id 98236657
+```
+
+### Status Update Checklist
+
+- [ ] When starting work: Set issue to "In Progress"
+- [ ] When creating PR: Add PR to board with "In Progress"
+- [ ] After merge: Set both issue and PR to "Done"
+- [ ] Update TODO.md to check off completed tasks
\ No newline at end of file
diff --git a/docs/TODO.md b/docs/TODO.md
index 2ad5aaa..032ef06 100644
--- a/docs/TODO.md
+++ b/docs/TODO.md
@@ -5,7 +5,7 @@ This document tracks the implementation progress of GhostPaste. Check off tasks
 ## 🏗️ Phase 1: Project Setup
 
 ### Initial Setup
-- [ ] Initialize Next.js 15 project with TypeScript (using `create-next-app`) - [#5](https://github.com/nullcoder/ghostpaste/issues/5)
+- [x] Initialize Next.js 15 project with TypeScript (using `create-next-app`) - [#5](https://github.com/nullcoder/ghostpaste/issues/5)
 - [ ] Set up Cloudflare Workers environment with wrangler - [#6](https://github.com/nullcoder/ghostpaste/issues/6)
 - [ ] Configure project for Next.js on Cloudflare Workers using @cloudflare/next-on-pages - [#6](https://github.com/nullcoder/ghostpaste/issues/6)
 - [ ] Configure Edge Runtime compatibility for all routes - [#6](https://github.com/nullcoder/ghostpaste/issues/6)