idkmesh

ONE: Continuous GitHub + ChatGPT Evolution Controller

Status: historical, non-canonical design; automation retired Date: 2026-08-28

This design is retained for provenance only. Its write-capable workflows were retired because the canonical ACE stack already owns observation, capacity, task-generation, and safety policy. Do not reactivate ONE as a parallel controller; transplant independently useful ideas into ACE through a bounded, reviewed change.

ONE means One Next Evolution.

Its purpose is to make IDKMesh continuously ask and answer one question:

Given the repository state right now, what is the single highest-value bounded action that improves verified capability, community reproduction, or the repository’s ability to improve itself?

ONE is deliberately conservative. It is not a bot that manufactures activity. It is a control loop that turns GitHub activity into evidence, chooses at most one next bounded task, and measures whether that task produced useful descendants.


1. Why ONE exists

IDKMesh already has:

The missing operational behavior is continuous convergence.

Without a controller, a self-evolving repository can become a self-expanding repository: more issues, more documents, more agents, and more automation without enough verified integration.

ONE therefore optimizes:

verified useful improvement * community multiplication * information gain
-------------------------------------------------------------------------
review attention + implementation cost + coordination noise + risk

and initially allows only one active generated execution task at a time.


2. What an iteration means

A GitHub event is not an iteration.

ONE defines an iteration as an evolution epoch:

observe
 -> construct repository state
 -> estimate review/community capacity
 -> generate candidate actions
 -> score candidates
 -> choose one bounded action
 -> expose it as a public GitHub task
 -> independent agent/human works it
 -> verify/integrate/reject
 -> measure outcome + descendants
 -> next epoch

Formally:

E_t = (S_t, A_t, a*_t, X_t, S_(t+1))

where:

A rejected idea can be a successful iteration when it removes uncertainty cheaply.


3. The two control planes

Plane A — GitHub-native reflex controller

Runs continuously through GitHub Actions and GitHub events.

Responsibilities:

This plane works without an LLM.

Plane B — ChatGPT cognitive worker

ChatGPT can be connected to GitHub and can be run as a scheduled recurring task where the product/account supports it.

The cognitive worker should:

  1. inspect the public ONE queue;
  2. inspect the highest-priority open one:agent-task;
  3. read the relevant repository context;
  4. solve or advance the task through a branch/PR, test, review artifact, research result, or clear blocker report;
  5. never merge or approve its own protected change;
  6. leave durable evidence in GitHub;
  7. stop after one bounded outcome per run.

GitHub Actions cannot invoke this exact ChatGPT web conversation by magic. The bridge is a ChatGPT scheduled task or another explicitly configured agent integration. The repository-side algorithm must therefore remain useful even when no ChatGPT cognitive worker is active.


4. Repository state

ONE derives a compact state vector:

S_t = [P, I, A, C, V, L, D, N, R]

where:

These are signals, not truth.


5. Review-capacity governor

Self-reproduction must slow down when verification becomes the bottleneck.

Use a logistic capacity gate:

Capacity(L) = 1 / (1 + exp((L - K) / tau))

Initial values:

K   = 8
Tau = 2

A simple v0 load proxy is:

L = open_PRs
  + 0.5 * stale_PRs
  + 1.5 * active_ONE_tasks

Interpretation:

The coefficients are hypotheses and must be calibrated from evidence.


6. Candidate action types

ONE does not ask an LLM to invent an unlimited plan. It first chooses among typed actions.

A. VERIFY_OR_UNBLOCK_PR

Use when an open PR is a high-value integration bottleneck.

Possible generated task:

Independently inspect PR #N, identify the smallest blocker, and return test/review evidence or a minimal corrective PR.

Community value: reviewers/security/test contributors can participate without owning the whole subsystem.

B. ADVANCE_PRIORITY_ISSUE

Use when no integration bottleneck dominates but a P0/high-priority issue blocks the product loop.

Possible generated task:

Reduce issue #N to one independently verifiable next artifact and implement or document that artifact.

C. ONBOARDING_SEED

Use only when newcomer-ready inventory is too low and review capacity is healthy.

Possible paths:

D. PUBLISH_EVIDENCE

Use after a meaningful verified experiment/result when the result is difficult for outsiders to discover or reproduce.

The output should be a reproducible public artifact, not promotional copy without evidence.

E. CONSOLIDATE

Use when review pressure or structural debt is high.

Actions include:

Consolidation is a growth strategy because lower contributor friction and reviewer load increase future carrying capacity.


7. Selection formula

For candidate action a:

ONE(a) =
    ExpectedVerifiedDelta(a)
  * InformationGain(a)
  * DependencyUnlock(a)
  * CommunityMultiplier(a)
  * Reversibility(a)
  * Capacity(L)
  -------------------------------------------------
    1
  + ReviewCost(a)
  + ImplementationCost(a)
  + CoordinationNoise(a)
  + SafetyRisk(a)

Select:

a* = argmax ONE(a)

subject to hard constraints.

Community multiplier

A useful community multiplier is:

CommunityMultiplier =
  1
  + newcomer_accessibility
  + reusable_surface
  + ownership_transfer
  + descendant_potential
  + reproducibility/shareability

This favors work that makes the next contribution easier.


8. Community reproduction model

The fastest sustainable growth comes from increasing conversion and reproduction, not manufacturing stars/comments.

Model the public contribution funnel as:

visitor
 -> understands
 -> finds bounded task
 -> claims task
 -> produces candidate
 -> receives review
 -> produces verified contribution
 -> returns
 -> enables another contributor

A conceptual viral coefficient is:

K_community =
  p_understand
  * p_claim
  * p_complete
  * p_reviewed
  * p_return
  * descendants_per_success

The target is eventually:

K_community > 1

but only while reviewer load remains stable.

The v0 controller intentionally uses max_active_generated_tasks = 1. Increase the branching factor only after measured evidence shows healthy completion, independent review, and return/descendant behavior.


9. The legitimate “growth hacks”

The repository should hack friction and conversion, not people.

High-leverage mechanisms:

  1. Every verified contribution leaves a child surface. A merge should ideally produce one reproducible/challenge/explain/extend opportunity.
  2. Make tasks forkable. A newcomer should be able to work on one bounded artifact without understanding the whole project.
  3. Turn results into shareable evidence. Reproducible benchmark results, visual reports, releases, demos, and negative findings attract more durable attention than generic promotion.
  4. Reduce time-to-first-success. Keep some tasks in a 15–60 minute range with observable acceptance criteria.
  5. Use role diversity. Coding, review, reproduction, research, security, documentation, UX, and explanation should all count as useful contribution paths.
  6. Transfer ownership. Prefer tasks that can create new reviewers/maintainers over tasks that deepen one-maintainer dependency.
  7. Expose uncertainty. Publicly visible unanswered questions let researchers and specialists enter where they have comparative advantage.
  8. Make successful patterns reproductive. If one issue format or experiment consistently produces verified descendants, replicate that structure.
  9. Backpressure aggressively. When review load grows, stop spawning and convert activity into verification/consolidation.
  10. Celebrate evidence, not vanity. Stars/forks/reactions can help discovery, but they never count as proof of project fitness.

Explicit non-strategies

ONE must not use:

These may create short-term attention while damaging the actual community reproduction number.


10. Public queue

The GitHub workflow maintains one issue:

[ONE] Continuous Evolution Queue

It reports:

The queue is the hand-off boundary between deterministic GitHub observation and humans/ChatGPT/other agents.


11. Generated task contract

A ONE-generated issue must be bounded and contain:

The controller should avoid duplicates and should not create a second active generated task while one is already open in v0.


12. ChatGPT scheduled-worker prompt

A suitable recurring cognitive-worker instruction is:

Inspect MSKazemi/idkmesh through the connected GitHub app. Read the ONE queue,
CURRENT_PRIORITIES, the repository improvement loop, and open ONE agent tasks.
If one ONE task is open, advance the highest-priority bounded task with an
inspectable GitHub artifact (branch/PR/test/research/review evidence) when safe.
Do not merge or approve your own changes. Do not create duplicate work. If the
repository is review-saturated, prefer verification/consolidation. If no ONE task
exists, inspect the repository and propose at most one high-value bounded issue
only when it passes the capacity and duplication gates. Record community impact
and evidence. Stop after one bounded outcome.

An hourly schedule is the maximum useful cadence for the ChatGPT scheduled-worker path. GitHub events remain the faster sensor path.


13. Autonomy ladder

ONE should earn autonomy.

Level 0 — Observe

Reports only.

Level 1 — Queue

Maintains one public queue/recommendation issue.

Level 2 — Spawn one bounded issue

Allowed only when:

Level 3 — Agent proposes PR

A human or external/scheduled ChatGPT agent may implement the task on a branch and open a PR.

Level 4 — Verified integration

Independent checks/review decide whether to integrate.

ONE does not autonomously self-approve/self-merge constitutional, governance, security, verification-policy, or evolution-controller changes.


14. Success metrics

Measure at least:

A fast-growing community with exploding review latency is not healthy growth.


15. v0 decision rule

For the initial controller:

if active_ONE_tasks >= 1:
    do not spawn
    recommend EXECUTE_OR_VERIFY
elif review_load > K:
    do not spawn
    recommend CONSOLIDATE
elif high_value_open_PR_exists:
    spawn one VERIFY_OR_UNBLOCK_PR task
elif high_priority_issue_exists:
    spawn one ADVANCE_PRIORITY_ISSUE task
elif newcomer_inventory_is_low and Capacity(L) is healthy:
    spawn one ONBOARDING_SEED
else:
    maintain queue and collect evidence

This is intentionally simple enough to audit and falsify.


16. Core principle

The repository should not try to become busy by itself. It should become better at creating the next independently useful contribution.

The desired long-term behavior is an autocatalytic community where each verified iteration increases the probability, quality, or independence of the next one—without requiring one maintainer to manually manufacture the community.