2.5 KiB
Agent-Consumable Minimum
Purpose
Define the minimum bar for saying reply-end-controls is ready for another AI agent to use directly, rather than merely continue developing.
Current state
The project is already:
- understandable by another agent
- reproducible as a Telegram/OpenClaw PoC
- documented well enough for engineering handoff
But it is not yet at the point where another agent can simply adopt it as a clean integration without understanding the current patch model.
Minimum bar for direct consumption
Another AI agent should be able to:
- understand what the feature does
- understand what environment it targets
- apply it without hand-editing runtime files
- verify it works
- roll it back if needed
Required deliverables
1. Clear integration entrypoint
There must be a single obvious entrypoint explaining:
- what to install
- what to patch
- what scripts to run
- what runtime assumptions exist
2. Apply path
Another agent must be able to apply the current PoC without inventing its own patch process.
Current direction:
scripts/apply-openclaw-poc-patch.sh
3. Verify path
Another agent must be able to verify:
- buttons appear
- callback is received
- state is written
- stop/continue affect later behavior
Current direction:
- acceptance instructions
- PoC reports
4. Rollback path
Another agent must be able to revert the patch safely.
Current direction:
scripts/rollback-openclaw-poc-patch.sh
5. Integration contract
Another agent should not need to reverse-engineer the feature from raw runtime patches.
It should have direct access to:
- state model
- callback contract
- Telegram rendering rules
- OpenClaw adapter assumptions
Missing pieces before this bar is truly met
The main gaps are:
- no single
HANDOFF.mdorINTEGRATION.mdentrypoint yet - the current implementation still relies on runtime patching rather than a clean installable integration unit
- acceptance is still partly human-driven instead of fully scripted
Recommended next tasks
- add
HANDOFF.md - add
INTEGRATION.md - add a user-facing apply/verify/rollback flow description
- tighten the acceptance steps into a smaller repeatable checklist
Completion rule
We can say the project is ready for another agent to directly use when:
- the repo contains a single handoff entrypoint
- patch application is reproducible
- patch rollback is reproducible
- verification steps are explicit and bounded
- the other agent does not need to inspect OpenClaw runtime internals before getting started