Skip to content

docs: clarify automation spec_ref exceptions#695

Open
chapel wants to merge 2 commits intomainfrom
fix/triage-automation-spec-ref
Open

docs: clarify automation spec_ref exceptions#695
chapel wants to merge 2 commits intomainfrom
fix/triage-automation-spec-ref

Conversation

@chapel
Copy link
Copy Markdown
Collaborator

@chapel chapel commented Mar 8, 2026

Summary

  • classify plan/design umbrella tasks without implementation specs as manual_only instead of forcing synthetic spec_ref links
  • document use of plan_ref plus derived spec-backed tasks for those umbrella cases
  • apply the first metadata correction batch by marking @01KJXQK4 manual_only and linking it to @plan-ui-ux-revamp

Verification

  • kspec tasks assess automation
  • kspec validate (still reports unrelated pre-existing schema/reference/completeness noise and historical automation-without-spec backlog outside this task scope)

Task: @01KJGRPX87E756YE1VFKXCWEZ3

Document that plan/design umbrella tasks should remain manual_only instead of getting a synthetic spec_ref, and point triage toward using plan_ref plus derived spec-backed tasks.

Task: @01KJGRPX87E756YE1VFKXCWEZ3

Co-Authored-By: OpenAI Codex <codex@openai.com>
Copy link
Copy Markdown
Collaborator Author

@chapel chapel left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review Summary

Task: @01KJGRPX87E756YE1VFKXCWEZ3
Spec: N/A (spec_ref is intentionally empty for this infra/manual-only task)

AC Coverage

  • N/A for this task because it has no linked implementation spec or inherited trait ACs

Scope / Spec Alignment

  • MUST-FIX: PR #695 is not isolated to this task. main...fix/triage-automation-spec-ref includes three earlier CI/E2E commits for task @01KJD106N5ZQ3VB9T3EV3BHYZK in addition to the docs commit for this task. That makes the review artifact invalid for @01KJGRPX87E756YE1VFKXCWEZ3.
  • The task notes describe scope limited to metadata corrections plus automation-triage documentation. The extra workflow/package changes are outside that scope.

Code Quality

  • Documentation updates themselves look consistent.
  • The blocking issue is PR hygiene and task/branch isolation, not the docs content.

Regression Check

  • npm test passed locally

Quality Gates

  • Regression suite passed
  • AC coverage reviewed and marked N/A
  • Spec alignment reviewed
  • PR scope isolated to this task

Please restack or recreate the PR so it contains only the changes for this task, then resubmit for review.

kspec --version
kspec --help

e2e:
Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

MUST-FIX: This PR is filed for @01KJGRPX87E756YE1VFKXCWEZ3, but this entire E2E workflow comes from the earlier CI task @01KJD106N5ZQ3VB9T3EV3BHYZK and is still in main...head. Restack or recreate the branch so this PR contains only the metadata/docs changes for the automation-triage task.

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