opencode-onboard 0.0.1

package/content/.opencode/skills/ob-userstory-az/SKILL.md

@@ -0,0 +1,206 @@
+---
+name: ob-userstory-az
+description: Parse Azure DevOps user story URL and create OpenSpec change. Use when user provides an Azure DevOps URL.
+license: MIT
+compatibility: Requires openspec CLI and Azure CLI.
+metadata:
+  author: copilots
+  version: "3.0"
+---
+
+**RTK - MANDATORY**
+
+Use `rtk` wrapper for ALL CLI commands:
+- `rtk az boards work-item show` NOT `az boards work-item show`
+- `rtk openspec new change` NOT `openspec new change`
+
+**Browser MCP tools are FORBIDDEN for all Azure DevOps operations.**
+
+---
+
+## Azure CLI Setup (One-Time)
+
+```bash
+az config set extension.dynamic_install_allow_preview=true
+az extension add --name azure-devops
+az login
+az devops login --organization https://dev.azure.com/plainconcepts
+```
+
+**PAT Token** — go to `https://dev.azure.com/plainconcepts/_usersSettings/tokens`
+Create with scopes: **Work Items (Read & Write)** + **Code (Read & Write)**
+
+---
+
+## Steps
+
+1. **Extract Work Item ID** from URL
+   - `?workitem=193208` → ID: 193208
+   - `/workitems/edit/193208` → ID: 193208
+
+2. **Fetch Work Item**
+   ```bash
+   rtk az boards work-item show --id 193208
+   ```
+   Do NOT use `--organization` flag (uses default org).
+
+3. **Extract Key Fields** from JSON response:
+   - `fields.System.Title` → Title
+   - `fields.System.Description` → Description (may be HTML — strip tags)
+   - `fields.System.WorkItemType` → Type
+   - `fields.System.IterationPath` → Sprint
+   - `fields.System.State` → State
+   - `fields.System.AcceptanceCriteria` → AC (if present)
+
+4. **Create OpenSpec Change**
+   ```bash
+   rtk openspec new change "us-{id}-{slug}"
+   ```
+
+---
+
+## Full Azure DevOps CLI Reference
+
+Use these for ALL DevOps operations — browser MCP is FORBIDDEN.
+
+### Work Items
+```bash
+# Read work item
+rtk az boards work-item show --id <id>
+
+# Update work item state
+rtk az boards work-item update --id <id> --state "Active"
+```
+
+### Pull Requests
+```bash
+# List open PRs
+rtk az repos pr list --repository <repo> --status active --top 5
+
+# Show PR details
+rtk az repos pr show --id <pr-id>
+
+# Create PR
+rtk az repos pr create \
+  --repository <repo> \
+  --source-branch feature/<id>-<slug> \
+  --target-branch main \
+  --title "feat(#<id>): <title>" \
+  --description "<description>"
+
+# Update PR description
+rtk az repos pr update --id <pr-id> --description "<text>"
+
+# Link work item to PR (run sequentially — not parallel)
+rtk az repos pr work-item add --id <pr-id> --work-items <work-item-id>
+```
+
+### PR Threads (Comments)
+```bash
+# Read all threads
+rtk az devops invoke \
+  --area git --resource pullRequestThreads \
+  --route-parameters project=PlainConcepts.CapacityTool repositoryId=<repo> pullRequestId=<id> \
+  --http-method GET --api-version 7.1
+
+# Post new comment thread (requires body.json)
+rtk az devops invoke \
+  --area git --resource pullRequestThreads \
+  --route-parameters project=PlainConcepts.CapacityTool repositoryId=<repo> pullRequestId=<id> \
+  --http-method POST --api-version 7.1 --in-file body.json
+
+# Reply to existing thread
+rtk az devops invoke \
+  --area git --resource pullRequestThreadComments \
+  --route-parameters project=PlainConcepts.CapacityTool repositoryId=<repo> pullRequestId=<id> threadId=<tid> \
+  --http-method POST --api-version 7.1 --in-file reply.json
+```
+
+### Comment Body JSON format
+```json
+{
+  "comments": [
+    {
+      "parentCommentId": 0,
+      "content": "Your markdown comment here.",
+      "commentType": 1
+    }
+  ],
+  "status": "active"
+}
+```
+
+For replies, `parentCommentId` should be the ID of the first comment in the thread (usually 1).
+
+---
+
+## Screenshot / Image Strategy
+
+**Never upload images as PR attachments.** Save to openspec change folder and reference via raw URL.
+
+### Save location
+```
+openspec/changes/{change-name}/images/{screenshot}.png
+```
+
+### Raw URL format (renders inline in PR comments)
+```
+https://dev.azure.com/plainconcepts/PlainConcepts.CapacityTool/_apis/git/repositories/{repo}/items?path=openspec/changes/{change}/images/{file}.png&versionType=branch&version={branch}&api-version=7.1
+```
+
+Do NOT use `_git/` URLs — they return HTML, not raw binary.
+
+### PR comment with screenshot
+```json
+{
+  "comments": [
+    {
+      "parentCommentId": 0,
+      "content": "## Screenshots\n\n![Description](https://dev.azure.com/plainconcepts/PlainConcepts.CapacityTool/_apis/git/repositories/{repo}/items?path=openspec/changes/{change}/images/{file}.png&versionType=branch&version={branch}&api-version=7.1)",
+      "commentType": 1
+    }
+  ],
+  "status": "active"
+}
+```
+
+---
+
+## URL Formats Reference
+
+```
+# Sprint board with work item
+https://dev.azure.com/{org}/{project}/_sprints/backlog/{team}/{project}/Sprint%20110?workitem=193208
+
+# Direct work item
+https://dev.azure.com/{org}/{project}/_workitems/edit/193208
+
+# PR
+https://dev.azure.com/{org}/{project}/_git/{repo}/pullrequest/{pr-id}
+```
+
+---
+
+## Output Format
+
+```
+## User Story Parsed
+
+**Work Item:** #193208
+**Title:** Roles CRUD
+**Type:** User Story
+**Iteration:** Sprint 110
+**State:** New
+
+**Change Created:** us-193208-roles-crud
+
+### Next Steps
+1. Review the proposal
+2. Say "implement the plan" to start implementation
+```
+
+## Constraints
+
+- This skill only PARSES and PROPOSES — implementation via openspec-apply-change
+- Always use `rtk` for CLI commands
+- Browser MCP tools FORBIDDEN for all DevOps operations

package/content/.opencode/skills/ob-userstory-gh/SKILL.md

@@ -0,0 +1,171 @@
+---
+name: ob-userstory-gh
+description: Parse GitHub Issue URL and create OpenSpec change. Use when user provides a GitHub Issue URL.
+license: MIT
+compatibility: Requires openspec CLI and gh CLI.
+metadata:
+  author: copilots
+  version: "1.0"
+---
+
+**Browser MCP tools are FORBIDDEN for all GitHub operations.**
+
+---
+
+## GitHub CLI Setup (One-Time)
+
+```bash
+gh auth login
+# Follow prompts — authenticate via browser or token
+```
+
+Verify:
+```bash
+gh auth status
+```
+
+---
+
+## Steps
+
+1. **Extract Issue Number** from URL
+   - `https://github.com/{owner}/{repo}/issues/42` → number: 42
+
+2. **Fetch Issue**
+   ```bash
+   gh issue view 42 --json number,title,body,labels,milestone,state
+   ```
+
+3. **Extract Key Fields** from JSON response:
+   - `number` → Issue number
+   - `title` → Title
+   - `body` → Description / acceptance criteria
+   - `labels` → Labels
+   - `milestone` → Milestone / sprint equivalent
+   - `state` → State (open/closed)
+
+4. **Create OpenSpec Change**
+   ```bash
+   openspec new change "gh-{number}-{slug}"
+   ```
+
+---
+
+## Full GitHub CLI Reference
+
+Use these for ALL GitHub operations — browser MCP is FORBIDDEN.
+
+### Issues
+```bash
+# Read issue
+gh issue view <number>
+
+# List open issues
+gh issue list --state open --limit 10
+
+# Update issue
+gh issue edit <number> --add-label "in-progress"
+```
+
+### Pull Requests
+```bash
+# List open PRs
+gh pr list --state open
+
+# Show PR details
+gh pr view <number>
+
+# Create PR
+gh pr create \
+  --base main \
+  --head feature/{slug} \
+  --title "feat: <title>" \
+  --body "<description>"
+
+# Update PR
+gh pr edit <number> --body "<text>"
+```
+
+### PR Comments
+```bash
+# Read PR comments
+gh pr view <number> --comments
+
+# Post PR comment
+gh pr comment <number> --body "Your markdown comment here."
+
+# Reply to review comment via API
+gh api repos/{owner}/{repo}/pulls/{pr-number}/comments/{comment-id}/replies \
+  --method POST \
+  --field body="Reply text here."
+```
+
+### Review Comments (structured)
+```bash
+# Get all review comments on a PR
+gh api repos/{owner}/{repo}/pulls/{pr-number}/comments
+
+# Get all reviews
+gh api repos/{owner}/{repo}/pulls/{pr-number}/reviews
+```
+
+---
+
+## Screenshot / Image Strategy
+
+**Never embed images as attachments.** Save to openspec change folder and reference via raw GitHub URL.
+
+### Save location
+```
+openspec/changes/{change-name}/images/{screenshot}.png
+```
+
+### Raw URL format (renders inline in PR comments)
+```
+https://raw.githubusercontent.com/{owner}/{repo}/{branch}/openspec/changes/{change}/images/{file}.png
+```
+
+### PR comment with screenshot
+```bash
+gh pr comment <number> --body "## Screenshots\n\n![Description](https://raw.githubusercontent.com/{owner}/{repo}/feature/{slug}/openspec/changes/{change}/images/{file}.png)"
+```
+
+---
+
+## URL Formats Reference
+
+```
+# Issue
+https://github.com/{owner}/{repo}/issues/{number}
+
+# PR
+https://github.com/{owner}/{repo}/pull/{number}
+
+# Raw file
+https://raw.githubusercontent.com/{owner}/{repo}/{branch}/{path}
+```
+
+---
+
+## Output Format
+
+```
+## Issue Parsed
+
+**Issue:** #{number}
+**Title:** {title}
+**State:** {state}
+**Milestone:** {milestone}
+
+**Change Created:** gh-{number}-{slug}
+
+### Next Steps
+1. Review the proposal
+2. Say "implement the plan" to start implementation
+```
+
+## Constraints
+
+- This skill only PARSES and PROPOSES — implementation via openspec-apply-change
+- Always use `gh` CLI for GitHub operations
+- Browser MCP tools FORBIDDEN for all GitHub operations

package/content/AGENTS.md

@@ -0,0 +1,90 @@
+# AGENTS.md — Bootstrap Mode
+
+> This project has not been initialized yet.
+> Your ONLY job right now is to run the initialization sequence below.
+> Do not do anything else until all steps are complete.
+
+## Trigger
+
+When the user says anything resembling initialization — "init", "initialize", "setup", "start", "bootstrap", "get started", "prepare" — execute all steps below in order. Do not ask for confirmation before starting.
+
+---
+
+## Initialization Sequence
+
+### Step 1 — Archive project history into OpenSpec
+
+Scan the codebase for any existing documentation, changelogs, ADRs, README files, or notable history that describes decisions already made in this project. Create an OpenSpec archive entry that captures this history so agents have context going forward.
+
+```bash
+openspec new change "project-history"
+```
+
+Write a `proposal.md` inside that change summarizing:
+- What this project is
+- Key decisions already made (inferred from code and docs)
+- Known tech debt or constraints visible in the codebase
+- Current state of the project
+
+Then archive it immediately:
+```bash
+openspec archive "project-history"
+```
+
+---
+
+### Step 2 — Generate DESIGN.md
+
+Read the current contents of `DESIGN.md`. It contains a prompt/command. Do the following:
+
+1. Copy the prompt text from `DESIGN.md` into memory
+2. Wipe `DESIGN.md` completely (write empty file)
+3. Execute the copied prompt against this codebase — analyze the design system, visual tokens, typography, colors, spacing, and UI patterns
+4. Write the result back into `DESIGN.md` following the format described in the prompt
+
+The output must be a real, populated `DESIGN.md` — not the prompt itself.
+
+---
+
+### Step 3 — Generate ARCHITECTURE.md
+
+Read the current contents of `ARCHITECTURE.md`. It contains a prompt/command. Do the following:
+
+1. Copy the prompt text from `ARCHITECTURE.md` into memory
+2. Wipe `ARCHITECTURE.md` completely (write empty file)
+3. Execute the copied prompt against this codebase — analyze the full architecture, structure, components, data flows, integrations, and tech stack
+4. Write the result back into `ARCHITECTURE.md` following the structure described in the prompt
+
+The output must be a real, populated `ARCHITECTURE.md` covering all sections the prompt describes — not the prompt itself.
+
+---
+
+### Step 4 — Rewrite this file
+
+Replace the entire contents of `AGENTS.md` with the real agent guidance template located at `.opencode/agents/.bootstrap/AGENTS.template.md`.
+
+---
+
+### Step 5 — Confirm
+
+Tell the user:
+
+```
+Initialization complete.
+
+- ARCHITECTURE.md generated
+- DESIGN.md generated
+- Project history archived in openspec
+- AGENTS.md updated with real guidance
+
+You're ready to work.
+```
+
+---
+
+## Guardrails During Init
+
+- Do NOT implement any features
+- Do NOT create branches or PRs
+- Do NOT modify any project source files
+- Only read source files for analysis — write only to ARCHITECTURE.md, DESIGN.md, AGENTS.md, and openspec/