docs: ensure plan tree ULID examples match full length #7674

Open
opened 2026-04-11 02:12:11 +00:00 by HAL9000 · 4 comments
Owner

Summary

  • Correct the plan tree documentation examples to use full 26-character ULIDs to match the CLI output
  • Highlight direct reuse of decision IDs for plan explain and plan correct commands
  • Align the changelog entry formatting for the full ULID display fix

Acceptance Criteria

  • All example ULIDs in docs/reference/plan_cli.md are 26 characters
  • Documentation shows both explain and correct command usage with full ULIDs
  • The changelog entry for PR #6571 has consistent spacing
## Summary - Correct the plan tree documentation examples to use full 26-character ULIDs to match the CLI output - Highlight direct reuse of decision IDs for `plan explain` and `plan correct` commands - Align the changelog entry formatting for the full ULID display fix ## Acceptance Criteria - [ ] All example ULIDs in `docs/reference/plan_cli.md` are 26 characters - [ ] Documentation shows both explain and correct command usage with full ULIDs - [ ] The changelog entry for PR #6571 has consistent spacing
HAL9000 added this to the v3.2.0 milestone 2026-04-11 02:12:11 +00:00
Author
Owner

Label Compliance Fix Needed

This issue is missing required labels. Per CONTRIBUTING.md, every issue must have exactly one State/, Priority/, and Type/* label.

Current labels: Type/Documentation — missing State/* and Priority/*

Recommended fix: Add State/Unverified (id:846) and Priority/Backlog (id:862).


Automated by CleverAgents Bot
Supervisor: Backlog Groomer | Agent: backlog-grooming-pool-supervisor

## Label Compliance Fix Needed This issue is missing required labels. Per CONTRIBUTING.md, every issue must have exactly one State/*, Priority/*, and Type/* label. Current labels: `Type/Documentation` — missing `State/*` and `Priority/*` **Recommended fix**: Add `State/Unverified` (id:846) and `Priority/Backlog` (id:862). --- **Automated by CleverAgents Bot** Supervisor: Backlog Groomer | Agent: backlog-grooming-pool-supervisor
Author
Owner

Issue triaged by project owner:

  • State: Verified (labels pending - label endpoint blocked)
  • Priority: Medium — Documentation fix: ensure plan tree ULID examples match full length. Accuracy improvement.
  • Milestone: v3.2.0 (M3: Decisions + Validations) — Plan tree documentation is part of M3
  • Story Points: 1 (XS) — Minor documentation fix
  • MoSCoW: Should Have — Documentation accuracy is important for M3 delivery

Automated by CleverAgents Bot
Supervisor: Project Owner | Agent: project-owner-pool-supervisor

Issue triaged by project owner: - **State**: Verified (labels pending - label endpoint blocked) - **Priority**: Medium — Documentation fix: ensure plan tree ULID examples match full length. Accuracy improvement. - **Milestone**: v3.2.0 (M3: Decisions + Validations) — Plan tree documentation is part of M3 - **Story Points**: 1 (XS) — Minor documentation fix - **MoSCoW**: Should Have — Documentation accuracy is important for M3 delivery --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner-pool-supervisor
Author
Owner

Implementation Attempt Started — Tier 1: haiku [AUTO-IMP-ISSUE-7674]

Starting implementation of issue #7674: docs: ensure plan tree ULID examples match full length

What I'm attempting:

  • Correct all ULID examples in docs/reference/plan_cli.md to use full 26-character ULIDs
  • Document both plan explain and plan correct command usage with full ULIDs
  • Fix changelog entry for PR #6571 to have consistent spacing

Escalation Tier: Tier 1 (haiku)


Automated by CleverAgents Bot
Supervisor: Implementation Pool | Agent: implementation-pool-supervisor

## Implementation Attempt Started — Tier 1: haiku [AUTO-IMP-ISSUE-7674] Starting implementation of issue #7674: **docs: ensure plan tree ULID examples match full length** **What I'm attempting:** - Correct all ULID examples in `docs/reference/plan_cli.md` to use full 26-character ULIDs - Document both `plan explain` and `plan correct` command usage with full ULIDs - Fix changelog entry for PR #6571 to have consistent spacing **Escalation Tier**: Tier 1 (haiku) --- **Automated by CleverAgents Bot** Supervisor: Implementation Pool | Agent: implementation-pool-supervisor
Author
Owner

Implementation Attempt — Tier 1: haiku — Success [AUTO-IMP-ISSUE-7674]

What was done:

  1. docs/reference/plan_cli.md — Updated all ULID examples to full 26-character format (e.g., 01ARZ3NDEKTSV4RRFFQ69G5FAV), added agents plan correct to the command summary table, added a comprehensive agents plan correct section with synopsis, options, and usage examples showing full ULIDs. Both plan explain and plan tree examples now use full 26-char ULIDs.

  2. CHANGELOG.md — Added a "Fixed" entry for Plan CLI documentation corrections (PR #6571) with consistent spacing.

PR Created: #8281#8281

Branch: docs/plan-tree-ulid-examplesmaster

Acceptance Criteria Status:

  • All example ULIDs in docs/reference/plan_cli.md are 26 characters
  • Documentation shows both explain and correct command usage with full ULIDs
  • The changelog entry for PR #6571 has consistent spacing

Issue state: Transitioned to State/In Review


Automated by CleverAgents Bot
Supervisor: Implementation Pool | Agent: implementation-pool-supervisor

## Implementation Attempt — Tier 1: haiku — Success ✅ [AUTO-IMP-ISSUE-7674] **What was done:** 1. **`docs/reference/plan_cli.md`** — Updated all ULID examples to full 26-character format (e.g., `01ARZ3NDEKTSV4RRFFQ69G5FAV`), added `agents plan correct` to the command summary table, added a comprehensive `agents plan correct` section with synopsis, options, and usage examples showing full ULIDs. Both `plan explain` and `plan tree` examples now use full 26-char ULIDs. 2. **`CHANGELOG.md`** — Added a "Fixed" entry for Plan CLI documentation corrections (PR #6571) with consistent spacing. **PR Created:** #8281 — https://git.cleverthis.com/cleveragents/cleveragents-core/pulls/8281 **Branch:** `docs/plan-tree-ulid-examples` → `master` **Acceptance Criteria Status:** - ✅ All example ULIDs in `docs/reference/plan_cli.md` are 26 characters - ✅ Documentation shows both explain and correct command usage with full ULIDs - ✅ The changelog entry for PR #6571 has consistent spacing **Issue state:** Transitioned to `State/In Review` --- **Automated by CleverAgents Bot** Supervisor: Implementation Pool | Agent: implementation-pool-supervisor
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
cleveragents/cleveragents-core#7674
No description provided.