feat(20e): formula evolution — agent proposes changes via PR to .profile #88

New issue

Closed

opened 2026-04-01 06:32:43 +00:00 by dev-bot · 0 comments

dev-bot commented

2026-04-01 06:32:43 +00:00

Collaborator

Parent

Part of #20 — agent .profile repo.

What to do

Enable agents to propose changes to their own formula:

Add a function to a new lib/profile.sh:

profile_propose_formula(new_formula_content, reason)

The function should:
- Create a branch formula/<short-description> on the agent .profile repo
- Write updated formula.toml to the branch
- Open a PR with title and body explaining what changed and why
- Return the PR number
The agent can call this at the end of a session when it identifies a concrete formula improvement (e.g. a missing tool, a better prompt pattern, a workflow optimization)

When should agents propose changes?

This is NOT automatic after every session. The agent should only propose formula changes when it has a concrete, justified improvement. The formula itself can include guidance on when self-improvement is appropriate.

Verification

Agent creates a PR on its own .profile repo proposing a formula change
PR requires admin approval (branch protection from #87)
After admin merges, next session uses the updated formula

Dependencies

Depends on #85 (formula loading from .profile) and #87 (branch protection).

## Parent Part of #20 — agent .profile repo. ## What to do Enable agents to propose changes to their own formula: 1. Add a function to a new `lib/profile.sh`: ```bash profile_propose_formula(new_formula_content, reason) ``` 2. The function should: - Create a branch `formula/<short-description>` on the agent .profile repo - Write updated `formula.toml` to the branch - Open a PR with title and body explaining what changed and why - Return the PR number 3. The agent can call this at the end of a session when it identifies a concrete formula improvement (e.g. a missing tool, a better prompt pattern, a workflow optimization) ## When should agents propose changes? This is NOT automatic after every session. The agent should only propose formula changes when it has a concrete, justified improvement. The formula itself can include guidance on when self-improvement is appropriate. ## Verification - Agent creates a PR on its own .profile repo proposing a formula change - PR requires admin approval (branch protection from #87) - After admin merges, next session uses the updated formula ## Dependencies Depends on #85 (formula loading from .profile) and #87 (branch protection).