Create Issue
Workflow
- •Detect the user is reporting a problem or asking to create an issue.
- •Confirm or ask for the issue title if it is not explicit.
- •Resolve the target directory.
- •If
00-docs/issues/exists in the current project, write the issue there. - •If
00-docs/does not exist, ask the user where to write the issue.
- •If
- •Determine the owner from git config at creation time.
- •Run
git config --get user.namein the current repo. - •If empty, ask the user for an owner name.
- •Run
- •Compute the issue date in
YYYY-MM-DD. - •Generate a slug from the issue title: lowercase, ASCII, replace spaces/punctuation with hyphens, collapse multiple hyphens, trim leading/trailing hyphens.
- •Create the file as
YYYY-MM-DD-issue-slug.mdin the target directory. - •Fill the template below, using the computed date for
dateandlast_updated, the git user forowner, and the confirmed issue title.
Template
code
--- date: YYYY-MM-DD owner: "<name>" repository: portal topic: "<Issue Title> — Issue Brief" status: draft last_updated: YYYY-MM-DD --- # <Issue Title> — Issue Brief ## Problem - Current behavior: - Pain: - Desired outcome: ## Scope - In scope: - Out of scope: ## UX / i18n - Routes/screens: - Key states (loading/empty/error): - i18n: all strings via `dictionaries/*` ## Data / sources - System of record: - Read/write paths: - Source mappings (if any): ## Rules / validation - R1: - R2: ## Testing - Unit tests: - Manual QA steps: ## Open questions - Q1: - Q2: