Skip to content

Bootstrap the Agentic Runtime research/ideation process - #1

Merged
rkoster merged 15 commits into
mainfrom
bootstrap-ideation-process
Jul 2, 2026
Merged

Bootstrap the Agentic Runtime research/ideation process#1
rkoster merged 15 commits into
mainfrom
bootstrap-ideation-process

Conversation

@rkoster

@rkoster rkoster commented Jun 25, 2026

Copy link
Copy Markdown
Contributor

Summary

Opens the working group's crowd-sourced research phase and puts the process itself up
for review before content arrives at volume.

This PR adds:

  • IDEATION.md — the ideation brief: a four-phase roadmap (research → workshop → emergent
    themes → POC/RFC). Only Phase 1 (research intake) is built; later phases are described,
    not scaffolded.
  • README.md, CONTRIBUTING.md, CODE_OF_CONDUCT.md — orientation, contribution
    workflow, and conduct.
  • research/ — a flat intake directory with the frontmatter schema (research/README.md),
    a copy-me TEMPLATE.md, and one worked example note (cf-runtime-gaps.md).
  • .github/ — CODEOWNERS routing to the WG leads, a PR template, and a lightweight CI
    check that validates each note's frontmatter, filename, and required sections.

Design notes

  • Themes are not predefined. Notes are organized flat and tagged; the workshop clusters
    tags into themes so the agenda emerges from what people contribute.
  • Lightweight by design. Research notes are low-risk; CI + a quick tech-lead check is
    the merge bar. Substantive review of ideas happens at the workshop.
  • Real seed notes will follow as separate PRs that exercise this very process.

Feedback wanted

Please review the process (the brief and contribution flow) — this PR exists to gather
that feedback before the research window opens.

rkoster added 12 commits June 25, 2026 18:44
Signed-off-by: rkoster <hi@rkoster.dev>
Signed-off-by: rkoster <hi@rkoster.dev>
Signed-off-by: rkoster <hi@rkoster.dev>
Signed-off-by: rkoster <hi@rkoster.dev>
Signed-off-by: rkoster <hi@rkoster.dev>
Signed-off-by: rkoster <hi@rkoster.dev>
Signed-off-by: rkoster <hi@rkoster.dev>
Signed-off-by: rkoster <hi@rkoster.dev>
Signed-off-by: rkoster <hi@rkoster.dev>
CF projects gate on a CLA signed via the EasyCLA bot (prompted on the
first PR), not a Developer Certificate of Origin. Point contributors at
EasyCLA and drop the git commit -s instructions so we don't ask others
to sign off unnecessarily.

Signed-off-by: rkoster <hi@rkoster.dev>
The worked example research/cf-runtime-gaps.md read as a definitive,
maintainer-authored list of Cloud Foundry gaps. Identifying gaps should
be an outcome of Phase 1 — synthesized at the workshop from the body of
research — not a starting point that pre-empts what contributors find or
crowds out their own gap analyses.

Remove that note (to revisit later) and recast the Phase 1 framing to
encourage outward-looking research into the wider agentic ecosystem,
with only a light Cloud Foundry lens per note. Repoint the former
'complete example' links at TEMPLATE.md and refresh the schema example
to an outward-looking topic.

Signed-off-by: rkoster <hi@rkoster.dev>

@beyhan beyhan 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.

LGTM (I have only a small comment on the pr template)

Comment thread .github/PULL_REQUEST_TEMPLATE.md Outdated
Co-authored-by: Beyhan Veli <beyhan.veli@sap.com>
@wayneeseguin

Copy link
Copy Markdown

This mirrors a lot of how I tend to think about this kind of workflow, so the structure looks like a good starting point to me.

One question: should we consider separating the lifecycle stages more explicitly? For example, ideas, research, and proposals.

Right now, ideas and research seem somewhat combined, which may be fine. I’m wondering whether a little separation plus cross-linking would make the repo easier to browse as it grows: browse raw ideas, follow them to related research, then see which proposals came out of that work.

This may be overkill, but it was the main thought that came to mind...

@jorbaum

jorbaum commented Jun 29, 2026

Copy link
Copy Markdown

LGTM. Good idea to have a linter for keeping a similar structure.

rkoster added 2 commits July 1, 2026 14:11
A full research note asks for sourcing and structure, which risks turning
away contributors who have a spark but no time to write it up — or getting
their PR rejected for not being a research note. Give ideas their own home
so nothing gets lost at the top of the funnel.

Add ideas/ with a README and a minimal TEMPLATE (a title is the only hard
requirement). Extend validate_notes.py with a light validate_idea() that
checks just the kebab-case filename and that a title is present, and widen
the lint workflow to cover ideas/**. Reframe the docs around two lanes and
a simple ideas -> research -> proposals pipeline, and cross-link the two so
an idea can graduate into a sourced note.

Signed-off-by: rkoster <hi@rkoster.dev>
Per review discussion, research is a reusable layer rather than a stage an
idea passes through: a single research note can back several ideas, and it's
the idea — once it has enough research behind it — that grows into a proposal.

Adjust the README, CONTRIBUTING, IDEATION, and ideas/README wording to match,
replacing the "ideas grow into research which feeds proposals" conveyor-belt
framing with two linked lanes plus a many-to-one ideas/research relationship.

Signed-off-by: rkoster <hi@rkoster.dev>
@rkoster

rkoster commented Jul 1, 2026

Copy link
Copy Markdown
Contributor Author

should we consider separating the lifecycle stages more explicitly? For example, ideas, research, and proposals. … browse raw ideas, follow them to related research, then see which proposals came out of that work.

Good call — adopted in 3829430. This PR adds an ideas/ lane as a low-barrier front of the funnel, kept distinct from sourced research notes, with cross-links between the two.

One refinement on the shape: rather than a strict ideas → research → proposals conveyor, I've framed research as a reusable layer — a single research note can back several ideas — and it's the idea that carries forward: one with enough research behind it can grow into a proposal. So the browse path you described still holds (raw ideas → the research backing them → the proposals they became), just with research shared across ideas rather than owned one-to-one.

proposals/ itself I've deferred — that's phase 4 (per-theme POC/RFC work that comes out of the workshop), so I'd rather add the directory when we reach it than seed an empty stage.

Thanks for the nudge; it sharpened the model.

@rkoster
rkoster requested review from beyhan and wayneeseguin July 1, 2026 12:39
@rkoster
rkoster merged commit 551cc4c into main Jul 2, 2026
2 checks passed
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.

4 participants