-
Notifications
You must be signed in to change notification settings - Fork 3.2k
Add cross-functional Archon workflow templates #1411
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Open
RickRinewalt
wants to merge
16
commits into
coleam00:dev
Choose a base branch
from
RickRinewalt:product-team-workflows
base: dev
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
Open
Changes from 15 commits
Commits
Show all changes
16 commits
Select commit
Hold shift + click to select a range
4115ea5
chore: update Homebrew formula for v0.3.9
github-actions[bot] 359b6d3
chore(release-skill): use --help (not version) for Step 1.5 smoke pro…
Wirasm 6f86402
chore(test-release-skill): preserve archon-stable across test cycles
Wirasm 0e9f1c8
fix(providers/pi): install PI_PACKAGE_DIR shim so Pi workflows run in…
Wirasm b99cee4
feat(providers): autodetect canonical binary install paths for Claude…
Wirasm f9f8775
fix(providers/test): use os.homedir() instead of $HOME in claude bina…
coleam00 5957c6e
fix(server): contain Discord login failure so it doesn't kill the ser…
coleam00 46874ca
docs(script-nodes): dedicated guide + teach the archon skill (#1362)
Wirasm 2c15439
docs/skill: general hardening — fix inaccuracies, fill workflow/CLI/e…
Wirasm ad13d83
chore(workflows): switch default Opus pin to opus[1m] alias (#1395)
Wirasm f094f2a
fix(workflow): migrate piv-loop plan handoff to $ARTIFACTS_DIR (#1398)
coleam00 a57d628
test(workflows): add anyFailed status derivation coverage for DAG exe…
coleam00 9122673
docs/skill: add parameter-matrix.md quick-lookup reference
coleam00 5679df0
Add cross-functional Archon workflow templates
RickRinewalt 294380f
Add product-team workflow user documentation
RickRinewalt 91292b1
Add AI coding pilot pitch
RickRinewalt File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,55 @@ | ||
| --- | ||
| description: Convert an approved PRD into a design brief and UX handoff plan | ||
| argument-hint: <prd path or feature description> | ||
| --- | ||
|
|
||
| # Design Brief | ||
|
|
||
| **Input**: $ARGUMENTS | ||
|
|
||
| --- | ||
|
|
||
| ## Mission | ||
|
|
||
| Create a design brief that gives implementation and QA enough context to build and validate the user experience. | ||
|
|
||
| ## Process | ||
|
|
||
| 1. Read `$ARTIFACTS_DIR/product/prd.md` if present. | ||
| 2. Inspect existing UI patterns, components, routes, and accessibility conventions. | ||
| 3. Identify required user flows, states, copy, errors, empty states, and permissions. | ||
| 4. Write `$ARTIFACTS_DIR/design/design-brief.md`. | ||
|
|
||
| ## Artifact Format | ||
|
|
||
| ```markdown | ||
| # Design Brief | ||
|
|
||
| ## UX Goal | ||
|
|
||
| ## Primary User Flow | ||
|
|
||
| ## Secondary Flows | ||
|
|
||
| ## States | ||
|
|
||
| - Loading: | ||
| - Empty: | ||
| - Error: | ||
| - Permission denied: | ||
| - Success: | ||
|
|
||
| ## Interaction Requirements | ||
|
|
||
| ## Accessibility Requirements | ||
|
|
||
| ## Existing Patterns To Reuse | ||
|
|
||
| ## Open Design Questions | ||
|
|
||
| ## Handoff Checklist | ||
| ``` | ||
|
|
||
| ## Output | ||
|
|
||
| Return the artifact path and any design blockers. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,42 @@ | ||
| --- | ||
| description: Verify design handoff completeness before implementation proceeds | ||
| argument-hint: <feature or PRD path> | ||
| --- | ||
|
|
||
| # Design Handoff Check | ||
|
|
||
| **Input**: $ARGUMENTS | ||
|
|
||
| --- | ||
|
|
||
| ## Mission | ||
|
|
||
| Confirm the design handoff is complete enough for implementation and QA. | ||
|
|
||
| ## Process | ||
|
|
||
| 1. Read the PRD and design brief artifacts. | ||
| 2. Check for required flows, states, acceptance notes, copy, and accessibility expectations. | ||
| 3. Write `$ARTIFACTS_DIR/design/handoff.md`. | ||
|
|
||
| ## Artifact Format | ||
|
|
||
| ```markdown | ||
| # Design Handoff | ||
|
|
||
| ## Status | ||
|
|
||
| Ready / Ready with caveats / Blocked | ||
|
|
||
| ## Required Implementation Notes | ||
|
|
||
| ## Required QA Notes | ||
|
|
||
| ## Missing Design Inputs | ||
|
|
||
| ## Approval Recommendation | ||
| ``` | ||
|
|
||
| ## Output | ||
|
|
||
| Return the handoff status and artifact path. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,48 @@ | ||
| --- | ||
| description: Review a PR or implementation against design and UX expectations | ||
| argument-hint: <PR number, branch, or implementation summary> | ||
| --- | ||
|
|
||
| # Design UI Review | ||
|
|
||
| **Input**: $ARGUMENTS | ||
|
|
||
| --- | ||
|
|
||
| ## Mission | ||
|
|
||
| Review the implementation for design consistency, accessibility, and user-flow quality. | ||
|
|
||
| ## Process | ||
|
|
||
| 1. Read `$ARTIFACTS_DIR/design/design-brief.md` and `$ARTIFACTS_DIR/development/implementation-report.md` if present. | ||
| 2. Inspect changed UI files and any screenshots or validation artifacts. | ||
| 3. Compare implementation against existing UI patterns. | ||
| 4. Write `$ARTIFACTS_DIR/design/ux-review.md`. | ||
|
|
||
| ## Artifact Format | ||
|
|
||
| ```markdown | ||
| # UX Review | ||
|
|
||
| ## Verdict | ||
|
|
||
| Pass / Pass with follow-ups / Blocked | ||
|
|
||
| ## Findings | ||
|
|
||
| | Severity | Area | Finding | Required Action | | ||
| |----------|------|---------|-----------------| | ||
|
|
||
| ## Accessibility Notes | ||
|
|
||
| ## Visual Consistency Notes | ||
|
|
||
| ## User Flow Notes | ||
|
|
||
| ## Approval Recommendation | ||
| ``` | ||
|
|
||
| ## Output | ||
|
|
||
| Return the verdict and artifact path. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,50 @@ | ||
| --- | ||
| description: Confirm that an approved PRD or implementation plan is ready to build | ||
| argument-hint: <prd path, plan path, issue, or feature request> | ||
| --- | ||
|
|
||
| # Development Confirm Plan | ||
|
|
||
| **Input**: $ARGUMENTS | ||
|
|
||
| --- | ||
|
|
||
| ## Mission | ||
|
|
||
| Confirm the implementation scope before code changes begin. | ||
|
|
||
| ## Process | ||
|
|
||
| 1. Read product, design, and security artifacts if present. | ||
| 2. Inspect the repo for relevant files, APIs, tests, and patterns. | ||
| 3. Identify the smallest safe implementation path. | ||
| 4. Write `$ARTIFACTS_DIR/development/implementation-plan.md`. | ||
|
|
||
| ## Artifact Format | ||
|
|
||
| ```markdown | ||
| # Implementation Plan | ||
|
|
||
| ## Scope | ||
|
|
||
| ## Non-Scope | ||
|
|
||
| ## Files And Modules | ||
|
|
||
| | Path | Action | Notes | | ||
| |------|--------|-------| | ||
|
|
||
| ## Implementation Steps | ||
|
|
||
| ## Validation Commands | ||
|
|
||
| ## Risks | ||
|
|
||
| ## Security Triggers | ||
|
|
||
| ## Rollback Notes | ||
| ``` | ||
|
|
||
| ## Output | ||
|
|
||
| Return the plan path and whether implementation is ready. |
48 changes: 48 additions & 0 deletions
48
.archon/commands/development/development-implementation-report.md
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,48 @@ | ||
| --- | ||
| description: Summarize implementation results for downstream review | ||
| argument-hint: <implementation context> | ||
| --- | ||
|
|
||
| # Development Implementation Report | ||
|
|
||
| **Input**: $ARGUMENTS | ||
|
|
||
| --- | ||
|
|
||
| ## Mission | ||
|
|
||
| Create an implementation report that downstream QA, security, docs, DevOps, and services workflows can consume. | ||
|
|
||
| ## Process | ||
|
|
||
| 1. Inspect git diff and commits. | ||
| 2. Read validation output and PR metadata if available. | ||
| 3. Write `$ARTIFACTS_DIR/development/implementation-report.md`. | ||
|
|
||
| ## Artifact Format | ||
|
|
||
| ```markdown | ||
| # Implementation Report | ||
|
|
||
| ## Summary | ||
|
|
||
| ## Changed Files | ||
|
|
||
| ## Behavior Changes | ||
|
|
||
| ## Validation Evidence | ||
|
|
||
| ## Known Limitations | ||
|
|
||
| ## Security-Relevant Changes | ||
|
|
||
| ## QA Notes | ||
|
|
||
| ## Docs Impact | ||
|
|
||
| ## Rollback Notes | ||
| ``` | ||
|
|
||
| ## Output | ||
|
|
||
| Return the report path and any downstream blockers. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,46 @@ | ||
| --- | ||
| description: Review deployment readiness, operational risk, and production prerequisites | ||
| argument-hint: <release candidate, PR, or implementation report> | ||
| --- | ||
|
|
||
| # DevOps Deployment Readiness | ||
|
|
||
| **Input**: $ARGUMENTS | ||
|
|
||
| --- | ||
|
|
||
| ## Mission | ||
|
|
||
| Determine whether the change is ready to deploy safely. | ||
|
|
||
| ## Process | ||
|
|
||
| 1. Read product, development, QA, security, and docs artifacts if present. | ||
| 2. Inspect migrations, configuration, env vars, infrastructure, CI, release scripts, and rollback paths. | ||
| 3. Write `$ARTIFACTS_DIR/devops/deployment-plan.md`. | ||
|
|
||
| ## Artifact Format | ||
|
|
||
| ```markdown | ||
| # Deployment Readiness | ||
|
|
||
| ## Verdict | ||
|
|
||
| Ready / Ready with caveats / Blocked | ||
|
|
||
| ## Deployment Steps | ||
|
|
||
| ## Required Config Or Secrets | ||
|
|
||
| ## Migration Notes | ||
|
|
||
| ## Monitoring And Alerts | ||
|
|
||
| ## Rollback Readiness | ||
|
|
||
| ## Blockers | ||
| ``` | ||
|
|
||
| ## Output | ||
|
|
||
| Return the verdict and artifact path. | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,44 @@ | ||
| --- | ||
| description: Convert incident notes into remediation and runbook updates | ||
| argument-hint: <incident summary or link> | ||
| --- | ||
|
|
||
| # DevOps Incident Follow-Up | ||
|
|
||
| **Input**: $ARGUMENTS | ||
|
|
||
| --- | ||
|
|
||
| ## Mission | ||
|
|
||
| Convert an incident into actionable remediation, runbook updates, and product follow-up. | ||
|
|
||
| ## Process | ||
|
|
||
| 1. Read incident notes from input. | ||
| 2. Identify root cause, contributing factors, detection gaps, and prevention tasks. | ||
| 3. Write `$ARTIFACTS_DIR/devops/incident-followup.md`. | ||
|
|
||
| ## Artifact Format | ||
|
|
||
| ```markdown | ||
| # Incident Follow-Up | ||
|
|
||
| ## Summary | ||
|
|
||
| ## Customer Impact | ||
|
|
||
| ## Root Cause | ||
|
|
||
| ## Detection And Response Gaps | ||
|
|
||
| ## Remediation Tasks | ||
|
|
||
| ## Runbook Updates | ||
|
|
||
| ## Product Follow-Up | ||
| ``` | ||
|
|
||
| ## Output | ||
|
|
||
| Return the artifact path and recommended issues to create. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,42 @@ | ||
| --- | ||
| description: Generate a rollback plan for risky releases | ||
| argument-hint: <release candidate or PR> | ||
| --- | ||
|
|
||
| # DevOps Rollback Plan | ||
|
|
||
| **Input**: $ARGUMENTS | ||
|
|
||
| --- | ||
|
|
||
| ## Mission | ||
|
|
||
| Create a concrete rollback plan for a risky release. | ||
|
|
||
| ## Process | ||
|
|
||
| 1. Read deployment, security, QA, and implementation artifacts. | ||
| 2. Identify rollback commands, data migration constraints, monitoring signals, and ownership. | ||
| 3. Write `$ARTIFACTS_DIR/devops/rollback-plan.md`. | ||
|
|
||
| ## Artifact Format | ||
|
|
||
| ```markdown | ||
| # Rollback Plan | ||
|
|
||
| ## Rollback Trigger | ||
|
|
||
| ## Fast Rollback Path | ||
|
|
||
| ## Data Considerations | ||
|
|
||
| ## Verification After Rollback | ||
|
|
||
| ## Owner | ||
|
|
||
| ## Communication Plan | ||
| ``` | ||
|
|
||
| ## Output | ||
|
|
||
| Return the rollback plan path. |
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
“Blocked” verdict isn’t actionable in the consuming workflow.
The artifact defines a
Blockedverdict, but.archon/workflows/devops/release-readiness.yamlrunsrollback-plananddevops-approvalunconditionally after this node — there is nowhen:/trigger_rulegating on the verdict. As written, aBlockedoutcome still progresses to rollback planning and approval, which dilutes the verdict’s meaning and risks deployments being approved despite known blockers.Recommend either:
Blockedthe command must fail (non-zero / explicit signal) so the workflow short-circuits, orrelease-readiness.yamlto gate downstream nodes on$deployment-readiness.output.verdict.🤖 Prompt for AI Agents