init

Initialize Workflow Environment

Set up the GitHub workflow environment for the current session. This command gathers project context, syncs issues, and creates environment variables for use by other commands.

Usage

/init                    # Initialize (skip if already done today)
/init --force            # Force re-initialization

Arguments

• --force (optional): Re-initialize even if already done today

What This Does

1. Detect Repository: Get owner/repo from git remote
2. Get User Info: Current GitHub username
3. Find Project Board: Auto-detect most recent active project board
4. Get Current Milestone: Find active milestone/sprint
5. Analyze Project Scopes: Suggest scope labels based on project structure
6. Label Stocktake: Check and report missing standard labels
7. Detect Branch: Get current branch and detect related issues and scope
8. Sync Issues: Fetch issues (defaults to all issues)
9. Set Preferences: Configure defaults (project type, issue filter, default project)
10. Create Setup Status: Track which setup steps are complete
11. Save Environment: Save context to .claude/github-workflows/env.json
12. Show Summary: Display workflow status, label stocktake, and setup recommendations

Environment File

Creates .claude/github-workflows/env.json:

{
  "initialized": "2025-01-15T10:30:00Z",
  "repository": {
    "owner": "owner",
    "name": "repo",
    "fullName": "owner/repo"
  },
  "user": {
    "login": "username",
    "name": "Full Name"
  },
  "projectBoard": {
    "number": 1,
    "title": "Sprint 5",
    "url": "https://github.com/orgs/owner/projects/1"
  },
  "milestone": {
    "title": "Sprint 5",
    "number": 3,
    "dueOn": "2025-01-31"
  },
  "branch": {
    "name": "feature/issue-42",
    "relatedIssues": [42],
    "detectedScope": "auth",
    "scopeLabel": "scope:auth"
  },
  "issueCache": {
    "count": 5,
    "lastSync": "2025-01-15T10:30:00Z"
  },
  "labels": {
    "existing": 15,
    "missing": ["priority:high", "priority:medium"],
    "recommended": ["bug", "feature", "enhancement"],
    "suggestedScopes": ["claude-component-builder", "self-improvement", "github-workflows"]
  },
  "setup": {
    "labelsComplete": false,
    "projectBoardExists": true,
    "milestonesExist": true
  },
  "preferences": {
    "projectType": "personal",
    "defaultIssueFilter": "all",
    "defaultProject": null
  }
}