# Dev Platform Workflow

> USE FOR: Read BEFORE any git or GitHub action (issue, branch, commit, push, PR create/review) — sets the issue-first, worktree-based default via issue-worktree-create. GitHub/Jira/Confluence: gh CLI, PR/commit/issue management, review style, public path hygiene; Atlassian Cloud when env vars are confirmed. DO NOT USE FOR: guessing credentials, unrelated tasks, broad rewrites, or generated runtime outputs.

- Skill: `i9wa4/dev-platform-workflow` (Agent Skill, multi-file: 7 files)
- Install (CLI): `npx skillmds@latest add i9wa4/dev-platform-workflow`
- Raw SKILL.md: https://api.skillmd.com/api/skills/i9wa4/dev-platform-workflow/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- License: MIT
- Author: i9wa4 (https://skillmd.com/u/i9wa4)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/i9wa4/dev-platform-workflow

---


# Dev Platform Workflow

Owns `gh` usage, GitHub issue/PR creation and inspection, public surface path
hygiene, commit/PR rules, and Atlassian access when env vars are confirmed.

## 1. Development Default

Before git/GitHub actions that edit files, create commits, or change
branches, work in a dedicated worktree — never edit or commit from the main
checkout, even for docs-only or single-line changes. See
`skills/dotfiles/references/workspace-guidance.md` for the worktree creation
commands, the no-issue-branch fallback, and entrypoint restrictions. Verify
`pwd`, branch, and status before editing.

## 2. Workflow

1. Inspect relevant files, repo conventions, and `git status`.
2. Read [Workflow Guide](references/github-workflow.md) before changing
   behavior or giving detailed instructions.
3. Before publication or PR creation, verify branch, upstream, base/head, and
   clean status; use the same-name remote destination workflow.
4. Make the smallest scoped change, run nearest checks, and report risk.

## 3. References

- [Workflow Guide](references/github-workflow.md)
- [Atlassian](references/atlassian.md)
- [Atlassian API Token](references/atlassian-api-token.md)