/init - Initialize Plugin Configuration

Set up the AI Dev Team plugin by answering a series of questions. This command creates your config/project.json and .env files automatically.

Usage

/init

Or with a project name:

/init "My Project Name"

What It Does

Walks you through configuring:

Atlassian discovery - Find your Cloud ID, existing projects, and spaces
Project selection - Connect to existing Jira project or set up new
User settings - Your account ID and preferences
GitHub integration (optional) - Repository information

Interactive Flow

Step 1: Atlassian Discovery

First, discover what's available in the user's Atlassian account:

Execute: Atlassian:getAccessibleAtlassianResources

## Atlassian Configuration

Checking your Atlassian access...

Found these Atlassian sites:
1. mycompany.atlassian.net (Cloud ID: abc123-def456...)

**Which site would you like to use?** [1]
> [User selects]

Step 2: Check for Existing Jira Projects

Execute: Atlassian:getVisibleJiraProjects with the selected Cloud ID

Found these Jira projects:
1. MAW - My Awesome Project (12 issues)
2. DEMO - Demo Project (5 issues)
3. TEST - Test Project (0 issues)

Step 3: Setup Mode Selection

Ask the user what they want to do:

## Setup Mode

**What would you like to do?**

1. **Connect to existing project** - Use an existing Jira project (recommended if you already have one set up)
2. **Start fresh** - I'll help you set up a new project name for tracking

> [User selects]

Flow A: Connect to Existing Project

If user selects "Connect to existing project":

A1: Select Jira Project

**Which Jira project do you want to connect?**

1. MAW - My Awesome Project
2. DEMO - Demo Project
3. TEST - Test Project

> [User selects: 1]

A2: Confirm Project Details

Execute: Atlassian:getJiraProjectIssueTypesMetadata with Cloud ID and project key

## Project: My Awesome Project (MAW)

Found configuration:
- Project Key: MAW
- Issue Types: Epic, Story, Task, Bug, Subtask

**Use this project name for the plugin?** [Y/n]
> [User confirms or enters different name]

**Brief description:** (optional, press Enter to skip)
> [User enters or skips]

A3: Select Confluence Space

Execute: Atlassian:getConfluenceSpaces with Cloud ID

## Confluence Space

Found these spaces:
1. MAW - My Awesome Project (ID: 12345)
2. TEAM - Team Documentation (ID: 67890)
3. [Create new space later]

**Which space should agents use for documentation?**
> [User selects: 1]

If no matching space exists:

No Confluence space found matching "MAW".

**Options:**
1. Use existing space: TEAM - Team Documentation
2. Skip Confluence setup (configure later)

> [User selects]

Flow B: Start Fresh

If user selects "Start fresh":

B1: Project Information

## New Project Setup

**What is your project name?**
> [User enters: "My New Project"]

**What project code/prefix should we use?** (e.g., MNP, PROJ)
> [User enters: "MNP"]

**Brief description:** (optional)
> [User enters description]

B2: Link to Jira Project

## Jira Project

You have these existing Jira projects:
1. MAW - My Awesome Project
2. DEMO - Demo Project
3. TEST - Test Project

**Which Jira project should agents use?**
(Select the project where stories and tasks will be created)

> [User selects]

Or if no suitable project exists:

**None of these match?**

You can either:
1. Select one of the above to use
2. Create a new Jira project first, then run /init again

> [User selects existing or exits to create new]

B3: Link to Confluence Space

## Confluence Space

Found these spaces:
1. MAW - My Awesome Project
2. TEAM - Team Documentation

**Which space should agents use for documentation?**
> [User selects]

Common Steps (Both Flows)

Step 4: Issue Types Configuration

Execute: Atlassian:getJiraProjectIssueTypesMetadata with Cloud ID and project key

## Issue Types

Found these issue types in [PROJECT]:
- Epic (ID: 10000) ✓
- Story (ID: 10001) ✓
- Task (ID: 10002) ✓
- Bug (ID: 10003) ✓
- Subtask (ID: 10004) ✓

All required issue types found! Configuring automatically.

If missing issue types:

## Issue Types

Found in [PROJECT]:
- Story (ID: 10001) ✓
- Task (ID: 10002) ✓
- Bug (ID: 10003) ✓

⚠️ Missing: Epic, Subtask

**Options:**
1. Continue without Epic/Subtask support
2. Exit and add these issue types to your Jira project first

> [User selects]

Step 5: User Settings

Execute: Atlassian:atlassianUserInfo

## User Settings

Found your Atlassian account:
- Name: John Smith
- Account ID: 5b10ac8d82e05b22cc7d4ef5

**Is this correct?** [Y/n]
> [User confirms]

**What name should agents use when communicating with you?**
> [User enters: "John" or accepts "John Smith"]

Step 6: GitHub (Optional)

## GitHub Integration (Optional)

**Do you want to configure GitHub integration?** [Y/n]
> [If yes:]

**GitHub repository owner** (username or org):
> [User enters: "mycompany"]

**Repository name:**
> [User enters: "awesome-project"]

**Default branch:** [main]
> [User accepts or changes]

Step 7: Create Configuration Files

Generate and write the configuration files:

config/project.json:

{
  "project": {
    "name": "My Awesome Project",
    "code": "MAW",
    "description": "E-commerce platform for small businesses"
  },
  "jira": {
    "cloudId": "abc123-def456-...",
    "projectKey": "MAW",
    "projectId": "10100",
    "issueTypes": {
      "epic": "10000",
      "story": "10001",
      "task": "10002",
      "bug": "10003",
      "subtask": "10004"
    },
    "workflow": {
      "backlog": "Backlog",
      "inProgress": "In Progress",
      "done": "Done"
    }
  },
  "confluence": {
    "cloudId": "abc123-def456-...",
    "spaceId": "12345",
    "spaceKey": "MAW"
  },
  "github": {
    "owner": "mycompany",
    "repo": "awesome-project",
    "defaultBranch": "main"
  },
  "agile": {
    "sprintLengthDays": 14,
    "storyPointScale": [1, 2, 3, 5, 8, 13]
  }
}

.env:

ATLASSIAN_ACCOUNT_ID=5b10ac8d82e05b22cc7d4ef5
STAKEHOLDER_NAME=John
TEAM_ROLE=stakeholder
NOTIFICATION_PREFERENCE=both
AGENT_VERBOSITY=normal

Step 8: Confirmation

## Configuration Complete!

Created:
- config/project.json
- .env

**Summary:**
- Project: My Awesome Project (MAW)
- Jira: MAW project on mycompany.atlassian.net
- Confluence: MAW space
- GitHub: mycompany/awesome-project

**Next steps:**
1. Run `/story` to create your first user story
2. Run `/sprint-status` to check sprint progress
3. Say "I need a feature for..." to engage the full team

**Optional:**
- Create Confluence parent pages: "Help me set up the Confluence page structure"
- Review configuration: `config/project.json`

Re-running /init

If configuration already exists:

## Existing Configuration Found

Found existing configuration:
- Project: My Awesome Project (MAW)
- Jira: Connected to MAW project
- Confluence: Connected to MAW space

**What would you like to do?**
1. Reconfigure everything (overwrites existing)
2. Update specific sections
3. Cancel

> [User selects]

If "Update specific sections":

**Which sections do you want to update?**
[ ] Project information (name, code, description)
[ ] Jira settings (project, issue types)
[ ] Confluence settings (space)
[ ] GitHub settings (repo)
[ ] User preferences (name, notifications)

> [User selects sections to update]

Error Handling

Error	Resolution
No Atlassian access	Guide user to connect MCP server first
No Jira projects visible	Check permissions or create a project in Jira
No Confluence spaces visible	Check permissions or create a space
Write permission denied	Suggest creating config/ directory

MCP Server Not Connected

## Atlassian MCP Not Connected

I can't access your Atlassian account. Please ensure the Atlassian MCP server is configured.

**To configure:**
1. Add to your Claude Code MCP settings:
   ```json
   {
     "mcpServers": {
       "atlassian": {
         "command": "npx",
         "args": ["-y", "@anthropic/mcp-server-atlassian"]
       }
     }
   }

Restart Claude Code
Run /init again


### No Projects Found

No Jira Projects Found

I couldn't find any Jira projects you have access to.

This could mean:

You don't have any projects yet - create one in Jira first
You don't have permission to view projects - check with your admin
Wrong Atlassian site selected - run /init again

To create a Jira project:

Go to your Atlassian site
Click "Projects" → "Create project"
Choose a template (Scrum or Kanban recommended)
Run /init again


---

## Manual Configuration Alternative

If MCP tools aren't available, guide manual setup:

Manual Configuration Mode

I couldn't auto-discover your Atlassian settings. Let's configure manually.

Enter your Atlassian Cloud ID: (Find it at: yoursite.atlassian.net/admin → Products → look for Cloud ID)

[User enters]

Enter your Jira project key: (The prefix used in issue IDs, like "MAW" in "MAW-123")

[User enters: "MAW"]

Enter your Confluence space key: (Found in the space URL: .../wiki/spaces/[SPACE_KEY]/...)