Skip to content

Add self-improvement flywheel problem document - #43

Closed
ralphbean wants to merge 2 commits into
mainfrom
agent-self-improvement-flywheel
Closed

Add self-improvement flywheel problem document#43
ralphbean wants to merge 2 commits into
mainfrom
agent-self-improvement-flywheel

Conversation

@ralphbean

Copy link
Copy Markdown
Member

Introduces a new problem doc exploring how fullsend learns from its own outputs and from human corrections to those outputs. This is distinct from production-feedback.md (which covers platform signals feeding into agent work) — the flywheel addresses how the quality of fullsend's own decisions feeds back into improving the system itself.

Covers: the capture problem, how improvements propagate (instruction refinement, context enrichment, golden-set expansion), the self-proposal mechanism, bootstrapping sequence, and feedback asymmetry.

Assisted-by: OpenCode claude-opus-4-6@default

@ralphbean

ralphbean commented Mar 20, 2026

Copy link
Copy Markdown
Member Author

Hold on this one. Itneeds to have its language repositioned on top of #43.

OpenCode and others added 2 commits March 24, 2026 14:54
Introduces a new problem doc exploring how fullsend learns from its own
outputs and from human corrections to those outputs. This is distinct
from production-feedback.md (which covers platform signals feeding into
agent work) — the flywheel addresses how the quality of fullsend's own
decisions feeds back into improving the system itself.

Covers: the capture problem, how improvements propagate (instruction
refinement, context enrichment, golden-set expansion), the self-proposal
mechanism, bootstrapping sequence, and feedback asymmetry.

Assisted-by: OpenCode claude-opus-4-6@default
…ction

- Remove Konflux-specific references per the org-agnostic repositioning
  (PR #42, now merged)
- Add "Deterministic tool extraction" subsection incorporating Marta's
  review insight from PR #38: agents discover which checks should exist,
  those get codified into linters/scanners/policies, and the
  non-deterministic scope shrinks over time — reducing AI coupling
- Add cross-references between flywheel and operational observability docs
- Add deterministic tool proposals to the self-proposal list

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@ralphbean
ralphbean force-pushed the agent-self-improvement-flywheel branch from 539e8dc to a8c5a4b Compare March 24, 2026 18:56
@ralphbean

Copy link
Copy Markdown
Member Author

The org-agnostic repositioning is done (rebased on main which includes PR #42). Also incorporated Marta's review feedback from PR #38 — her insight about agents discovering which checks should become deterministic tools is now a full subsection ("Deterministic tool extraction") under "How improvements propagate." The two docs cross-reference each other.

Ready for review again.

@ralphbean

Copy link
Copy Markdown
Member Author

Dropping this as its not exactly a problem in the way that the other problem documents are "problems". It's (really) more of an opportunity/feature.

@ralphbean ralphbean closed this Apr 3, 2026
@ben-alkov
ben-alkov deleted the agent-self-improvement-flywheel branch April 23, 2026 16:58
ralphbean added a commit that referenced this pull request May 11, 2026
Add lychee as a pre-commit hook and standalone `make lint-md-links`
target to catch broken in-repo links and anchors in markdown files.

Fix all existing broken links:
- Wrong anchor fragment in ADR 0002 (heading was renamed)
- Missing "repo-" in ADR 0013 filename (2 references)
- Dangling self-improvement-flywheel.md links → point to closed PR #43
- Dangling experiments/guardrails-eval links → point to fullsend-ai/experiments repo
- Wrong relative paths for ADR 0019 from web/ and web/admin/
- Wrong relative path for ADR 0023 from skills/writing-user-docs/
- Dangling design doc link in a plan checklist

Noticed the need for this in PR #770.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
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