// 1. Repository ID + Pipeline ID
const workspace = await mcp__zenhub__getWorkspacePipelinesAndRepositories();
const repoId = workspace.githubRepositories.find(r = >   /* select GitHub repo */).id;

// 2. Issue Type ID (level: 1=Initiative, 2=Project, 3=Epic, 4=Feature/Bug/Task, 5=Sub-task)
const issueTypes = await mcp__zenhub__getIssueTypes({ repositoryId: repoId });
const initiativeType = issueTypes.find(t = >   t.name ===  " Initiative " ); // may be absent → fallback to Project/Epic top-level
const projectType = issueTypes.find(t = >   t.name ===  " Project " ); // may be absent → fallback to Epic top-level
const epicTypeId = issueTypes.find(t = >   t.name ===  " Epic " ).id;
const featureTypeId = issueTypes.find(t = >   t.name ===  " Feature " ).id;
const subtaskTypeId = issueTypes.find(t = >   t.name ===  " Sub-task " ).id;

0. Priority review (score dependency/value/risk/effort → p0/p1/p2 per issue)
   ↓ (labels are immutable after creation — review MUST precede creation)
0.5. Create Initiative issue, if requested (createGitHubIssue + issueTypeId=Initiative)
   ↓
1. Create Project issue, if requested (createGitHubIssue + issueTypeId=Project, parentIssueId=Initiative when created)
   ↓
2. Create Epic issue (createGitHubIssue + issueTypeId=Epic, parentIssueId=Project, or =Initiative directly if no Project)
   ↓
3. Create Story issues (createGitHubIssue + issueTypeId=Feature × N, parentIssueId=Epic)
   ↓
4. Create Sub-tasks (createGitHubIssue + issueTypeId=Sub-task × M, parentIssueId=Story)
   ↓
5. Verify parent-child relationships (already set via parentIssueId; fix with setParentForIssues)
   ↓
6. Set Story Points (setIssueEstimate) AND timeline dates (setDatesForIssue)
   ↓ ⚠️ BOTH required — SP without dates leaves the Epic off the Goals  &   Planning roadmap
7. Pipeline sorting (moveIssueToPipeline, descending priority order: P0 → P1 → P2)
   ↓
8. Sprint assignment for P0 Stories when requested (addIssuesToSprints)

mcp__zenhub__createGitHubIssue({
  title:  " {strategic goal name} " ,
  body:  " {body} " ,            // Strategic goal, wrapped Project/Epic list
  repositoryId: repoId,      // Dynamic query
  issueTypeId: initiativeType.id, // Dynamic query (fallback if absent)
  labels: [ " initiative " ,  " p0 " ]
})

mcp__zenhub__createGitHubIssue({
  title:  " {project/milestone name} " ,
  body:  " {body} " ,            // Goals, Epic list, priority table
  repositoryId: repoId,      // Dynamic query
  issueTypeId: projectType.id, // Dynamic query (fallback if absent)
  parentIssueId:  " {initiative_graphql_id} " , // When under an Initiative
  labels: [ " project " ,  " p0 " ]
})

const epic = await mcp__zenhub__createGitHubIssue({
  title:  " {feature} feature implementation " ,
  body:  " {body} " ,
  repositoryId: repoId,      // Dynamic query
  issueTypeId: epicTypeId,    // Dynamic query
  parentIssueId:  " {project_graphql_id} "   // When under a Project (or the Initiative ' s id directly, if no Project level)
})

// ⚠️ REQUIRED for roadmap visibility — set BOTH estimate and dates:
await mcp__zenhub__setIssueEstimate({ issueId: epic.id, estimate: totalPoints });
await mcp__zenhub__setDatesForIssue({
  issueId: epic.id,
  startDate: startDate,                            //  " YYYY-MM-DD " 
   endDate: endDate,                                //  " YYYY-MM-DD " 
   zenhubOrganizationId: workspace.zenhubOrganization.id,
});

mcp__zenhub__createGitHubIssue({
  title:  " {feature} list screen " ,
  body:  " {body} " ,
  repositoryId: repoId,         // Dynamic query
  issueTypeId: featureTypeId,    // Dynamic query
  parentIssueId:  " {epic_graphql_id} " 
 })

mcp__zenhub__createGitHubIssue({
  title:  " [{PREFIX}-001-01] Table column definition " ,
  body:  " {body} " ,
  repositoryId: repoId,         // Dynamic query
  issueTypeId: subtaskTypeId,    // Dynamic query
  parentIssueId:  " {story_graphql_id} " 
 })

project, {project_slug}, p{priority}

epic, feature, {feature_name}, kobic, p{priority}

story, {feature_name}, {screen_type}, kobic, p{priority}

New Issues → Icebox → Product Backlog → Sprint Backlog → In Progress → Review/QA

.claude/docs/{feature}/zenhub/
├── epic.md
└── stories/
    ├── list_story.md
    ├── detail_story.md
    └── form_story.md