Skip to content

docs(roadmap): August 2026 planning refresh - #5689

Open
ascerra wants to merge 5 commits into
mainfrom
docs/august-2026-roadmap
Open

docs(roadmap): August 2026 planning refresh#5689
ascerra wants to merge 5 commits into
mainfrom
docs/august-2026-roadmap

Conversation

@ascerra

@ascerra ascerra commented Jul 28, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Refresh docs/roadmap.md for the July 28 planning session: Now / Next / Later delivery horizons (flat deliverable tables, not ranked workstream categories)
  • Add July 2026 done recap; tracking links span fullsend-ai/fullsend and fullsend-ai/agents
  • Preserve prior published roadmaps in docs/archived-roadmap.md (Foundation / April–May, June planning, July planning) so monthly history is not lost when the live page rotates
  • Address PR review feedback: Ralph’s Now rows, spell out / then drop the contributor-meeting parenthetical, archive Foundation instead of deleting it

Archive (docs/archived-roadmap.md)

  • Archive-only banner for humans and AI reviewers (links/priorities may be stale — expected)
  • Skim-friendly monthly sections (Now/Next/Later titles or July’s At a glance table)
  • Full published text collapsed behind expanders; VitePress sidebar entry: Archived roadmaps
  • Excluded from lychee so historical links do not fail CI (Makefile + .pre-commit-config.yaml)

Review follow-ups included

Why docs/problems/platform-nativeness.md is in this PR

The August roadmap rewrite removed the old section headings (#infrastructure, #cross-forge-orchestration, etc.). platform-nativeness.md still linked to those fragments, so the repo’s markdown link linter fails on commit/CI until those references are updated. This PR retargets that sentence to the roadmap generally (GitLab MVP, cross-forge orchestration, Kubernetes/OpenShift) without depending on deleted anchors.

Test plan

  • Preview docs/roadmap.md on the PR (tables render, links open)
  • Preview docs/archived-roadmap.md (monthly summaries visible; expanders show full snapshots)
  • Spot-check a few fullsend# / agents# tracking URLs
  • Confirm platform-nativeness.md no longer references removed roadmap fragments
  • Confirm lychee excludes docs/archived-roadmap.md

@ascerra
ascerra requested a review from a team as a code owner July 28, 2026 19:06
@qodo-code-review

This comment was marked as spam.

@fullsend-ai-review

fullsend-ai-review Bot commented Jul 28, 2026

Copy link
Copy Markdown

🤖 Review · ⚠️ Cancelled · Started 7:07 PM UTC · Ended 7:14 PM UTC
Commit: cc65f7d · View workflow run →

@qodo-code-review

This comment was marked as spam.

@github-actions

github-actions Bot commented Jul 28, 2026

Copy link
Copy Markdown

Site preview

Preview: https://485c1151-site.fullsend-ai.workers.dev

Commit: f928bac7bdf122edcf6e6188a4af1ead00199aab

@codecov

This comment was marked as spam.

ascerra and others added 2 commits July 28, 2026 15:15
Replace ranked workstream categories with Now/Next/Later delivery
horizons from the July 28 planning board, including a July done recap
and tracking across fullsend and agents. Update platform-nativeness
links that pointed at removed roadmap anchors.

Signed-off-by: Adam Scerra <ascerra@redhat.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
Signed-off-by: Adam Scerra <ascerra@redhat.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
@ascerra
ascerra force-pushed the docs/august-2026-roadmap branch from 77a2c20 to afc06e9 Compare July 28, 2026 19:15
@fullsend-ai-review

fullsend-ai-review Bot commented Jul 28, 2026

Copy link
Copy Markdown

🤖 Review · ⚠️ Cancelled · Started 7:15 PM UTC · Ended 7:16 PM UTC
Commit: 77a2c20 · View workflow run →

@fullsend-ai-review

fullsend-ai-review Bot commented Jul 28, 2026

Copy link
Copy Markdown

🤖 Finished Review · ✅ Success · Started 7:17 PM UTC · Completed 7:29 PM UTC
Commit: afc06e9 · View workflow run →

@fullsend-ai-review

fullsend-ai-review Bot commented Jul 28, 2026

Copy link
Copy Markdown

Review

Findings

High

  • [protected-path] .pre-commit-config.yaml:166 — This PR modifies .pre-commit-config.yaml, a protected governance/infrastructure file. The change adds --exclude-path docs/archived-roadmap.md to the lychee markdown link linter. The PR has no linked issue providing explicit authorization for modifying this protected path. Human approval is required for all protected-path modifications.
    Remediation: A human reviewer must approve this change. The modification is a 1-line addition to exclude the new archived roadmap file from link checking — reasonable given the file contains intentionally stale historical links, but human sign-off on infrastructure file changes is always required.

Next steps:

  • /fs-fix — agent addresses review findings automatically
  • /fs-fix <your instruction> — agent fixes with your specific guidance
  • Push commits directly — review re-runs automatically on push
  • /fs-fix-stop — disable automatic fix runs for this PR
Previous run

Review

Findings

High

  • [protected-path] .pre-commit-config.yaml:166 — This PR modifies .pre-commit-config.yaml, a protected governance/infrastructure file. The change adds --exclude-path docs/archived-roadmap.md to the lychee markdown link linter. The PR has no linked issue providing explicit authorization for modifying this protected path. Human approval is required for all protected-path modifications.
    Remediation: A human reviewer must approve this change. The modification is a 1-line addition to exclude the new archived roadmap file from link checking — reasonable given the file contains intentionally stale historical links, but human sign-off on infrastructure file changes is always required.

Next steps:

  • /fs-fix — agent addresses review findings automatically
  • /fs-fix <your instruction> — agent fixes with your specific guidance
  • Push commits directly — review re-runs automatically on push
  • /fs-fix-stop — disable automatic fix runs for this PR
Previous run (2)

Looks good to me


Labels: PR modifies only documentation files under docs/

fullsend-ai-review[bot]

This comment was marked as outdated.

@fullsend-ai-review fullsend-ai-review Bot added ready-for-merge All reviewers approved — ready to merge component/docs User-facing documentation labels Jul 28, 2026

@waynesun09 waynesun09 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Automated review pass — 3 findings on docs/roadmap.md (see inline comments). No blocking issues beyond what's noted; posting as informational review only.

Comment thread docs/roadmap.md

- See [#267](https://github.com/fullsend-ai/fullsend/issues/267)

## Foundation (April–May 2026)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

MEDIUM: Foundation (Apr–May 2026) section deleted with no mention, only home for MVP/history facts

This PR deletes main's entire ## Foundation (April–May 2026) section (main:docs/roadmap.md:220-232 — MVP timeline, "20+ Konflux repositories," "fullsend is using fullsend" dogfooding note, core architecture bullets) with no mention in the PR description. Verified via git log -S "Foundation (done)" that this section (created 2026-05-14 in 739bf26) survived two full roadmap rewrites (36ac3a5 June 9 refresh, 57820bb July 1 refresh — which only renamed it from "Foundation (done)" to "Foundation (April–May 2026)") without being cut, unlike the monthly "N (done)" recap which is an established, intentionally-rotating section (and correctly rolls June→July in this same PR). Verified docs/architecture.md:199 retains the "repo is the coordinator" principle, but concrete facts specific to this section (MVP date, Konflux repo count, dogfooding claim) appear nowhere else in the live docs tree.

Suggestion: Restore a trimmed version of this permanent milestone/history anchor, or explicitly call out the removal in the PR description and confirm the underlying facts have a durable home elsewhere before merging.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Hm maybe we should have a 2nd file where we store the past roadmap and milestone data to preserve it?

I'm going to do this and collect the previously removed roadmap for past months there aswell. Call it archived-roadmap.md

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Done — created docs/archived-roadmap.md with:

  • Archive-only banner for humans/AI reviewers
  • Quick reference for Foundation + June 2026 (done)
  • Full snapshots from May post-MVP, early June, June planning, and July-as-merged (with source commit SHAs)

Also linked from live roadmap.md, added a VitePress sidebar entry, and excluded the archive from lychee so historical links do not fail CI.

Comment thread docs/roadmap.md
| Review-fix loop | Less human mechanical iteration | [fullsend#5666](https://github.com/fullsend-ai/fullsend/issues/5666) · [fullsend#5550](https://github.com/fullsend-ai/fullsend/issues/5550) · [agents#447](https://github.com/fullsend-ai/agents/issues/447) · [agents#343](https://github.com/fullsend-ai/agents/issues/343) · [agents#478](https://github.com/fullsend-ai/agents/issues/478) |
| Contributor meeting | Broader contributor call (incl. RH AI) | — |
| Per-workflow cost visibility | Cost by workflow type | [fullsend#5361](https://github.com/fullsend-ai/fullsend/issues/5361) · [fullsend#5537](https://github.com/fullsend-ai/fullsend/issues/5537) |
| Jira poller | Jira events → agents | [fullsend#3812](https://github.com/fullsend-ai/fullsend/issues/3812) · [fullsend#4885](https://github.com/fullsend-ai/fullsend/issues/4885) · [fullsend#3428](https://github.com/fullsend-ai/fullsend/issues/3428) · [fullsend#2269](https://github.com/fullsend-ai/fullsend/issues/2269) |

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

MEDIUM: "Now" row cites PRs #3812/#3428 as Jira-poller evidence, but both have live ADR-number collisions with main

The new "Jira poller" row (this line) cites fullsend#3812 and fullsend#3428; "Example custom agent that responds to Jira" (next row) also cites #3812. Verified via gh pr view --json files and the ADR files on main: #3812 adds docs/ADRs/0069-jira-project-enrollment-via-cli.md, but main's 0069 slot is already 0069-ready-made-configuration-presets.md (itself correctly tracked by #4910 "Epic: ADR 0069" and #4914, which this same roadmap cites two rows down). #3428 adds docs/ADRs/0068-privacy-allowlist-for-poll-input-drivers.md, but main's 0068 slot is already 0068-public-community-mint-architecture.md (Accepted). Both PRs are currently OPEN with reviewDecision=CHANGES_REQUESTED and neither can merge without renumbering — a structural blocker the roadmap doesn't surface for work framed as ~30-day "Now" delivery.

Suggestion: Note the blocker inline for the Jira poller row (e.g. "pending ADR renumber"), or confirm with the #3812/#3428 authors that they'll move to free ADR slots before relying on this as near-term roadmap evidence.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

The PR author will fix the ADR numbers as they go I don't want to get into that level of detail here on the roadmap

Comment thread docs/roadmap.md Outdated
| PR risk assessment | Risk signal on PRs | [fullsend#4698](https://github.com/fullsend-ai/fullsend/issues/4698) |
| Basic auto-merge capability | Smallest safe foothold + config | [fullsend#2791](https://github.com/fullsend-ai/fullsend/issues/2791) · [fullsend#3016](https://github.com/fullsend-ai/fullsend/issues/3016) |
| Review-fix loop | Less human mechanical iteration | [fullsend#5666](https://github.com/fullsend-ai/fullsend/issues/5666) · [fullsend#5550](https://github.com/fullsend-ai/fullsend/issues/5550) · [agents#447](https://github.com/fullsend-ai/agents/issues/447) · [agents#343](https://github.com/fullsend-ai/agents/issues/343) · [agents#478](https://github.com/fullsend-ai/agents/issues/478) |
| Contributor meeting | Broader contributor call (incl. RH AI) | — |

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

MEDIUM: Unexplained internal-style "RH AI" abbreviation added to public roadmap

Added on this line: "Contributor meeting | Broader contributor call (incl. RH AI) | —". This docs site targets external contributor communities. "RH AI" appears nowhere else in the repo, and the project's actual convention when referencing the parent org is to spell out "Red Hat" in full (e.g. docs/landscape.md, docs/ADRs/0068, docs/spikes/2026-05-25-*) — never abbreviated. docs/glossary.md asks PRs introducing new terminology to add an entry, which wasn't done here. Other partners in the same table (OpenShell, Ansible, TektonCD) are fully spelled out, making this parenthetical stand out as unexplained internal shorthand in public planning prose.

Suggestion: Spell out what "RH AI" refers to (e.g. "Red Hat AI"), or replace with an unambiguous public-facing term; remove the parenthetical if it isn't meant for public disclosure.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Contributor meeting outcome is now just Broader contributor call

Comment thread docs/roadmap.md Outdated
| PR risk assessment | Risk signal on PRs | [fullsend#4698](https://github.com/fullsend-ai/fullsend/issues/4698) |
| Basic auto-merge capability | Smallest safe foothold + config | [fullsend#2791](https://github.com/fullsend-ai/fullsend/issues/2791) · [fullsend#3016](https://github.com/fullsend-ai/fullsend/issues/3016) |
| Review-fix loop | Less human mechanical iteration | [fullsend#5666](https://github.com/fullsend-ai/fullsend/issues/5666) · [fullsend#5550](https://github.com/fullsend-ai/fullsend/issues/5550) · [agents#447](https://github.com/fullsend-ai/agents/issues/447) · [agents#343](https://github.com/fullsend-ai/agents/issues/343) · [agents#478](https://github.com/fullsend-ai/agents/issues/478) |
| Contributor meeting | Broader contributor call (incl. RH AI) | — |

@ralphbean ralphbean Jul 29, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
| Contributor meeting | Broader contributor call (incl. RH AI) ||
| Contributor meeting | Broader contributor call (incl. RH AI) ||
| Agent contribution example | Help users see how to improve fullsend; make it easier to contribute | [fullsend#5720](https://github.com/fullsend-ai/fullsend/issues/5720) |

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

@deboer-tim here, adding that concrete idea for improving the "contributability".

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Captured in the Now table as Agent contribution examplefullsend#5720.

Comment thread docs/roadmap.md
| ------------------------------------------ | -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| PR risk assessment | Risk signal on PRs | [fullsend#4698](https://github.com/fullsend-ai/fullsend/issues/4698) |
| Basic auto-merge capability | Smallest safe foothold + config | [fullsend#2791](https://github.com/fullsend-ai/fullsend/issues/2791) · [fullsend#3016](https://github.com/fullsend-ai/fullsend/issues/3016) |
| Review-fix loop | Less human mechanical iteration | [fullsend#5666](https://github.com/fullsend-ai/fullsend/issues/5666) · [fullsend#5550](https://github.com/fullsend-ai/fullsend/issues/5550) · [agents#447](https://github.com/fullsend-ai/agents/issues/447) · [agents#343](https://github.com/fullsend-ai/agents/issues/343) · [agents#478](https://github.com/fullsend-ai/agents/issues/478) |

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
| Review-fix loop | Less human mechanical iteration | [fullsend#5666](https://github.com/fullsend-ai/fullsend/issues/5666) · [fullsend#5550](https://github.com/fullsend-ai/fullsend/issues/5550) · [agents#447](https://github.com/fullsend-ai/agents/issues/447) · [agents#343](https://github.com/fullsend-ai/agents/issues/343) · [agents#478](https://github.com/fullsend-ai/agents/issues/478) |
| Review-fix loop | Less human mechanical iteration | [fullsend#5666](https://github.com/fullsend-ai/fullsend/issues/5666) · [fullsend#5550](https://github.com/fullsend-ai/fullsend/issues/5550) · [agents#447](https://github.com/fullsend-ai/agents/issues/447) · [agents#343](https://github.com/fullsend-ai/agents/issues/343) · [agents#478](https://github.com/fullsend-ai/agents/issues/478) |
| Versioned docs | Better docs experience for users | [fullsend#5717](https://github.com/fullsend-ai/fullsend/issues/5717) · [fullsend #5718](https://github.com/fullsend-ai/fullsend/issues/5718) |

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Added — Versioned docs with fullsend#5717 and fullsend#5718.

Comment thread docs/roadmap.md
| Per-workflow cost visibility | Cost by workflow type | [fullsend#5361](https://github.com/fullsend-ai/fullsend/issues/5361) · [fullsend#5537](https://github.com/fullsend-ai/fullsend/issues/5537) |
| Jira poller | Jira events → agents | [fullsend#3812](https://github.com/fullsend-ai/fullsend/issues/3812) · [fullsend#4885](https://github.com/fullsend-ai/fullsend/issues/4885) · [fullsend#3428](https://github.com/fullsend-ai/fullsend/issues/3428) · [fullsend#2269](https://github.com/fullsend-ai/fullsend/issues/2269) |
| Example custom agent that responds to Jira | BYOA pattern for Jira | [fullsend#3812](https://github.com/fullsend-ai/fullsend/issues/3812) |
| Triage agent works in response to Jira | Default triage from Jira | [fullsend#2264](https://github.com/fullsend-ai/fullsend/issues/2264) |

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
| Triage agent works in response to Jira | Default triage from Jira | [fullsend#2264](https://github.com/fullsend-ai/fullsend/issues/2264) |
| Triage agent works in response to Jira | Default triage from Jira | [fullsend#2264](https://github.com/fullsend-ai/fullsend/issues/2264) |
| Make agent status comments configurable | Reduce agent spam on issues for users who don't want it | [fullsend#3697](https://github.com/fullsend-ai/fullsend/issues/3697) |

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Added — Make agent status comments configurable with fullsend#3697.

Add Ralph's Now rows, spell out Red Hat AI, and move Foundation plus
prior published roadmap snapshots into archived-roadmap.md.

Signed-off-by: Adam Scerra <ascerra@redhat.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
@fullsend-ai-review

fullsend-ai-review Bot commented Aug 2, 2026

Copy link
Copy Markdown

🤖 Finished Review · ✅ Success · Started 2:18 PM UTC · Completed 2:30 PM UTC
Commit: 275ce34 · View workflow run →

fullsend-ai-review[bot]

This comment was marked as outdated.

@fullsend-ai-review fullsend-ai-review Bot removed the ready-for-merge All reviewers approved — ready to merge label Aug 2, 2026
Restructure archived-roadmap.md into skim-friendly monthly editions with
collapsed full snapshots, and remove the contributor-meeting parenthetical.

Signed-off-by: Adam Scerra <ascerra@redhat.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
@fullsend-ai-review

fullsend-ai-review Bot commented Aug 2, 2026

Copy link
Copy Markdown

🤖 Review · ⚠️ Cancelled · Started 2:46 PM UTC · Ended 2:48 PM UTC
Commit: 834e716 · View workflow run →

Signed-off-by: Adam Scerra <ascerra@redhat.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
@fullsend-ai-review

fullsend-ai-review Bot commented Aug 2, 2026

Copy link
Copy Markdown

🤖 Finished Review · ✅ Success · Started 2:49 PM UTC · Completed 3:03 PM UTC
Commit: f928bac · View workflow run →

@fullsend-ai-review fullsend-ai-review Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

See the review comment for full details.

Comment thread .pre-commit-config.yaml
- id: lint-md-links
name: lint markdown links
entry: lychee --offline --no-progress --include-fragments --exclude-path node_modules --exclude-path experiments '**/*.md'
entry: lychee --offline --no-progress --include-fragments --exclude-path node_modules --exclude-path experiments --exclude-path docs/archived-roadmap.md '**/*.md'

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[high] protected-path

This PR modifies .pre-commit-config.yaml, a protected governance/infrastructure file. The change adds --exclude-path docs/archived-roadmap.md to the lychee markdown link linter. The PR has no linked issue providing explicit authorization for modifying this protected path. Human approval is required for all protected-path modifications.

Suggested fix: A human reviewer must approve this change. The modification is a 1-line addition to exclude the new archived roadmap file from link checking — reasonable given the file contains intentionally stale historical links, but human sign-off on infrastructure file changes is always required.

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

Labels

component/docs User-facing documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants