dev-platform-workflow · diff
v1.0.0 to v1.0.0
6 added, 3 removed. Audit A to A.
---
- # Maintenance note: keep "otherwise change any code in the current repository"
- # last in the implementation-intent enumeration. The trigger grader constrains
- # its final enumerated phrase, so reordering or removing it can reduce coverage.
name: dev-platform-workflow
license: MIT
metadata:
version: "1.0.0"
description: |
USE FOR: Implement, fix, add, or otherwise change any code in the current repository — read this BEFORE starting, and 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.
---
+
+ <!--
+ Maintenance note: keep "otherwise change any code in the current repository"
+ last in the implementation-intent enumeration. The trigger grader constrains
+ its final enumerated phrase, so reordering or removing it can reduce coverage.
+ -->
# 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)