Skip to content

Feat/add atd workflow facades#1417

Closed
rpogula2014 wants to merge 2 commits into
Fission-AI:mainfrom
ATD-ONP:feat/add-atd-workflow-facades
Closed

Feat/add atd workflow facades#1417
rpogula2014 wants to merge 2 commits into
Fission-AI:mainfrom
ATD-ONP:feat/add-atd-workflow-facades

Conversation

@rpogula2014

@rpogula2014 rpogula2014 commented Jul 22, 2026

Copy link
Copy Markdown

Summary by CodeRabbit

  • New Features

    • Added full and lightweight ATD change workflows for ticket intake, analysis, planning, implementation, verification, and closure.
    • Added ATD-specific triage with eligibility checks and automatic escalation from lightweight to full workflows when needed.
    • Added dedicated ATD commands and skills for each journey stage.
    • Updated the default workflow profile to use the ATD journey alongside explore and update.
    • Added standards-store integration and conformance checks during implementation.
  • Bug Fixes

    • Closure now requires all tracked tasks to be complete before archiving, with no override.
  • Documentation

    • Added ATD setup, standards, adoption, configuration, and lite-eligibility guidance.

Initial commit of the ATD adoption track on top of upstream v1.6.0
(additive only — no engine changes):

- schemas/atd-sdlc: full pipeline ticket → analysis → (specs, design) →
  solution-doc → tasks; Jira/Confluence intake with grilling protocol,
  branch-alignment suggestion, confirmed idempotent write-back,
  code-as-truth analysis (SHA + file:line), AC traceability, scaled
  solution document, mandatory final task group (standards conformance,
  reconciliation, publication, Jira closure)
- schemas/atd-sdlc-lite: three-artifact pipeline for low-risk
  corrections; semantically-gated triage sidecar (all-pass + lite
  recommendation + lite choice), embedded canonical 13-condition
  eligibility table, one-way escalation incl. late escalation via
  tasks.lite.md
- atd-change-triage workflow (skill + /opsx:atd-triage command) in
  CORE_WORKFLOWS; registered across all enumerating surfaces incl.
  tool-detection
- docs/atd: config template, standards-store conventions,
  lite-eligibility table, adoption track with pilot metrics, bootstrap
- OpenSpec changes: add-atd-sdlc-schema and add-atd-sdlc-lite-triage
  (implemented), add-atd-docs-site and add-atd-workflow-facades
  (proposed)
- tests: schema resolution/gates, instruction contracts, cross-surface
  condition-list parity (normalized ordered comparison), escalation
  status, instruction assembly with rules/references, triage-only
  detection — full suite 2095 passing

External prerequisite: atd-standards store (placeholder seeded from the
atd-angular skill; angular real, other three stacks pending stack leads).
Add atd-continue, atd-apply, atd-verify, and atd-close as thin façades
over the generic continue/apply/verify/archive workflows, composed from
new shared parameterized instruction-body builders (generic output stays
byte-for-byte identical, locked by snapshots). Each façade names its
journey position, embeds the shared ATD schema guard (atd-sdlc /
atd-sdlc-lite only), and hands off to the next step; close hard-gates on
apply state "all_done" with no override, states the delta-spec merge
procedure inline, and never performs closure work itself.

Recompose CORE_WORKFLOWS as the five ATD workflows plus explore and
update; generic ids stay available via the custom profile. Register the
façades across every enumerating surface, add a registry-parity test so
an omission fails CI, map atd command→skill references for skills-only
delivery, reuse the exported WORKFLOW_TO_SKILL_DIR in init (fixes stale
local copy leaving façade skills behind on delivery switch), and point
init/update onboarding at /opsx:atd-triage. Regenerate the committed
skills/ distribution (17 skills).

Implements openspec/changes/add-atd-workflow-facades (18/18 tasks).
@rpogula2014
rpogula2014 requested a review from TabishB as a code owner July 22, 2026 18:27
@coderabbitai

coderabbitai Bot commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: cddf50c4-eb8f-43d3-b107-337d51e4be78

📥 Commits

Reviewing files that changed from the base of the PR and between 27b22ab and 85f42ea.

⛔ Files ignored due to path filters (1)
  • test/core/templates/__snapshots__/generic-workflow-parity.test.ts.snap is excluded by !**/*.snap
📒 Files selected for processing (79)
  • .changeset/add-atd-workflow-facades.md
  • .gitignore
  • AGENTS.md
  • docs/atd/adoption-track.md
  • docs/atd/bootstrap.md
  • docs/atd/bootstrap.sh
  • docs/atd/config-template.yaml
  • docs/atd/lite-eligibility.md
  • docs/atd/standards-store.md
  • openspec/changes/add-atd-docs-site/.openspec.yaml
  • openspec/changes/add-atd-docs-site/design.md
  • openspec/changes/add-atd-docs-site/proposal.md
  • openspec/changes/add-atd-docs-site/specs/atd-developer-docs/spec.md
  • openspec/changes/add-atd-docs-site/tasks.md
  • openspec/changes/add-atd-sdlc-lite-triage/.openspec.yaml
  • openspec/changes/add-atd-sdlc-lite-triage/design.md
  • openspec/changes/add-atd-sdlc-lite-triage/proposal.md
  • openspec/changes/add-atd-sdlc-lite-triage/specs/atd-change-triage/spec.md
  • openspec/changes/add-atd-sdlc-lite-triage/specs/atd-sdlc-lite-workflow/spec.md
  • openspec/changes/add-atd-sdlc-lite-triage/tasks.md
  • openspec/changes/add-atd-sdlc-schema/.openspec.yaml
  • openspec/changes/add-atd-sdlc-schema/design.md
  • openspec/changes/add-atd-sdlc-schema/proposal.md
  • openspec/changes/add-atd-sdlc-schema/specs/atd-sdlc-workflow/spec.md
  • openspec/changes/add-atd-sdlc-schema/specs/solution-documentation/spec.md
  • openspec/changes/add-atd-sdlc-schema/specs/standards-integration/spec.md
  • openspec/changes/add-atd-sdlc-schema/tasks.md
  • openspec/changes/add-atd-workflow-facades/.openspec.yaml
  • openspec/changes/add-atd-workflow-facades/design.md
  • openspec/changes/add-atd-workflow-facades/proposal.md
  • openspec/changes/add-atd-workflow-facades/specs/atd-workflow-facades/spec.md
  • openspec/changes/add-atd-workflow-facades/tasks.md
  • schemas/atd-sdlc-lite/schema.yaml
  • schemas/atd-sdlc-lite/templates/analysis.md
  • schemas/atd-sdlc-lite/templates/tasks.md
  • schemas/atd-sdlc-lite/templates/ticket.md
  • schemas/atd-sdlc/schema.yaml
  • schemas/atd-sdlc/templates/analysis.md
  • schemas/atd-sdlc/templates/design.md
  • schemas/atd-sdlc/templates/solution.md
  • schemas/atd-sdlc/templates/spec.md
  • schemas/atd-sdlc/templates/tasks.md
  • schemas/atd-sdlc/templates/ticket.md
  • skills/atd-change-apply/SKILL.md
  • skills/atd-change-close/SKILL.md
  • skills/atd-change-continue/SKILL.md
  • skills/atd-change-triage/SKILL.md
  • skills/atd-change-verify/SKILL.md
  • src/core/init.ts
  • src/core/profile-sync-drift.ts
  • src/core/profiles.ts
  • src/core/shared/skill-generation.ts
  • src/core/shared/tool-detection.ts
  • src/core/templates/skill-templates.ts
  • src/core/templates/workflows/apply-change.ts
  • src/core/templates/workflows/archive-change.ts
  • src/core/templates/workflows/atd-apply.ts
  • src/core/templates/workflows/atd-close.ts
  • src/core/templates/workflows/atd-continue.ts
  • src/core/templates/workflows/atd-triage.ts
  • src/core/templates/workflows/atd-verify.ts
  • src/core/templates/workflows/atd-workflow-shared.ts
  • src/core/templates/workflows/continue-change.ts
  • src/core/templates/workflows/verify-change.ts
  • src/core/update.ts
  • src/utils/command-references.ts
  • test/commands/config-profile.test.ts
  • test/commands/config.test.ts
  • test/core/artifact-graph/atd-sdlc-lite-schema.test.ts
  • test/core/artifact-graph/atd-sdlc-schema.test.ts
  • test/core/atd-close-gate.test.ts
  • test/core/atd-facades-workflow.test.ts
  • test/core/atd-triage-workflow.test.ts
  • test/core/init.test.ts
  • test/core/profiles.test.ts
  • test/core/shared/skill-generation.test.ts
  • test/core/shared/tool-detection.test.ts
  • test/core/templates/generic-workflow-parity.test.ts
  • test/core/update.test.ts

📝 Walkthrough

Walkthrough

The PR adds ATD full and lite schemas, introduces a five-step ATD workflow façade journey, changes the default core profile, wires skill and command generation, adds strict close gating, and expands documentation and test coverage.

Changes

ATD workflow and schema rollout

Layer / File(s) Summary
Schema contracts and templates
schemas/atd-sdlc/**, schemas/atd-sdlc-lite/**, openspec/changes/add-atd-sdlc-schema/**, openspec/changes/add-atd-sdlc-lite-triage/**
Adds full and lite artifact pipelines, standards requirements, triage routing, escalation rules, templates, and task completion contracts.
Workflow façade builders
src/core/templates/workflows/*
Adds ATD triage, continue, apply, verify, and close templates; parameterizes generic builders; and enforces ATD schema guards and close completion gating.
Profile and delivery wiring
src/core/profiles.ts, src/core/shared/*, src/core/init.ts, src/core/update.ts, src/utils/command-references.ts
Makes the ATD journey the core profile, keeps generic workflows available through custom profiles, and updates generation, detection, installation, synchronization, and onboarding paths.
Validation coverage
test/core/**, test/commands/**
Adds schema graph, escalation, close-gate, façade parity, registry, installation, profile, and update tests.
ATD operating documentation
AGENTS.md, docs/atd/*, openspec/changes/add-atd-docs-site/**
Documents ATD setup, standards-store usage, lite eligibility, adoption sequencing, and a planned developer documentation site.

Estimated code review effort: 4 (Complex) | ~60 minutes

Sequence Diagram(s)

sequenceDiagram
  participant Developer
  participant Triage
  participant OpenSpec
  participant Apply
  participant Verify
  participant Close

  Developer->>Triage: Provide Jira ticket and repository context
  Triage->>OpenSpec: Create change with selected ATD schema
  OpenSpec-->>Developer: Return change path and artifact status
  Developer->>OpenSpec: Generate planning artifacts
  Developer->>Apply: Execute tracked tasks and standards checks
  Apply->>Verify: Hand off after all tracked tasks complete
  Verify->>Close: Hand off after verification report
  Close->>OpenSpec: Check apply state and synchronize deltas
  OpenSpec-->>Close: Return all_done state and archive paths
Loading

Possibly related issues

Possibly related PRs

Suggested reviewers: tabishb, alfred-openspec

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Warning

There were issues while running some tools. Please review the errors and either fix the tool's configuration or disable the tool if it's a critical failure.

🔧 Checkov (3.3.8)
docs/atd/config-template.yaml

Traceback (most recent call last):
File "/usr/local/bin/checkov", line 2, in
from checkov.main import Checkov
ModuleNotFoundError: No module named 'checkov'

openspec/changes/add-atd-docs-site/.openspec.yaml

Traceback (most recent call last):
File "/usr/local/bin/checkov", line 2, in
from checkov.main import Checkov
ModuleNotFoundError: No module named 'checkov'

openspec/changes/add-atd-sdlc-lite-triage/.openspec.yaml

Traceback (most recent call last):
File "/usr/local/bin/checkov", line 2, in
from checkov.main import Checkov
ModuleNotFoundError: No module named 'checkov'

  • 4 others

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant