Skip to content

[AISOS-2496] Test Forge bug workflow: correct stale draft-attachment documentation - #338

Closed
forgeSmith-bot wants to merge 1 commit into
forge-sdlc:mainfrom
forgeSmith-bot:forge/aisos-2496
Closed

[AISOS-2496] Test Forge bug workflow: correct stale draft-attachment documentation#338
forgeSmith-bot wants to merge 1 commit into
forge-sdlc:mainfrom
forgeSmith-bot:forge/aisos-2496

Conversation

@forgeSmith-bot

Copy link
Copy Markdown
Collaborator

Summary

This PR corrects stale documentation regarding Forge's interactive draft review process. It replaces outdated references to serializing proposed items into JSON draft files and uploading/downloading them as Jira attachments with the correct implementation of using state-backed durable workflow state (plan_draft and tasks_draft).

Changes

Documentation Updates

  • docs/guide/labels.md: Updated the forge:direct-mode label description and interactive draft review workflow steps to reference state-backed durable workflow state instead of JSON attachments, and updated the /forge approve command description.
  • docs/guide/feature-workflow.md: Updated Epic Decomposition and Task Generation guides to remove references to forge-epics-draft.json and forge-tasks-draft.json attachments, replacing them with state-backed workflow state tracking.
  • docs/developer-guide.md: Cleaned up the /forge approve description in the command reference table to remove references to deleting draft attachments.

Implementation Notes

  • This is a documentation-only fix intended to align the user guides and developer references with the actual, current implementation of the Forge state machine.
  • A repository-wide search was conducted across all Markdown documentation files to ensure no lingering references to the old attachment-based workflow remain.

Testing

  • Verified that all documentation changes correctly represent current system behavior.
  • Performed a workspace-wide search for deprecated terms such as forge-epics-draft.json, forge-tasks-draft.json, and draft attachment to confirm no other stale occurrences remain.

Related Tickets


Generated by Forge SDLC Orchestrator

…feature workflow, and developer guide

Detailed description:
- Replaced references to Jira draft attachments and JSON file serialization/deletion with state-backed durable workflow state in docs/guide/labels.md
- Updated docs/guide/feature-workflow.md to align with state-backed draft workflow state tracking for Epic Decomposition and Task Generation stage references, removing draft JSON file references (forge-epics-draft.json/forge-tasks-draft.json)
- Updated docs/developer-guide.md to remove the reference to deleting draft attachments from the /forge approve command description
- Verified that all draft-attachment documentation is fully up-to-date and accurate

Closes: AISOS-2497
@forgeSmith-bot

Copy link
Copy Markdown
Collaborator Author

🤖 Reviewing a Forge pull request

To send code feedback to Forge, open Files changed, select Review changes, and submit a Request changes review. Forge will address the review feedback automatically and push updates to this pull request.

Regular comments are ignored by the review workflow. Use them for conversation or the Forge commands below:

  • /forge rebase - Merge the base branch (e.g. main) into this PR branch, with conflicts resolved by AI.
  • /forge skip-gate <name> - Skip a named CI check (substring match) for this PR. This setting persists across subsequent pushes.
  • /forge unskip-gate <name> - Remove a previously set CI check skip.

@eshulman2 eshulman2 closed this Sep 6, 2026
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.

2 participants