📦 deps(thirdparty): update snapshots
This commit is contained in:
@@ -1,205 +1,35 @@
|
||||
---
|
||||
name: accint-solve
|
||||
description: "Route agent work through AccInt's MCP memory loop: retrieve prior outcomes, resolve frames, and close commitments with evidence."
|
||||
category: ai-agents
|
||||
risk: safe
|
||||
source: community
|
||||
description: Route a goal through acc's scored-memory loop via acc_act(runtime="solve"); deliberate any returned brain_frame and submit via continue.
|
||||
risk: unknown
|
||||
source: https://github.com/maxbaluev/accreted-intelligence/tree/main/plugins/claude/skills/solve
|
||||
source_repo: maxbaluev/accreted-intelligence
|
||||
source_type: community
|
||||
date_added: "2026-06-15"
|
||||
author: maxbaluev
|
||||
tags: [mcp, memory, ai-agents, coding-agents, workflow]
|
||||
tools: [claude, codex, cursor, gemini, opencode]
|
||||
license: "Apache-2.0"
|
||||
license_source: "https://github.com/maxbaluev/accreted-intelligence/blob/main/LICENSE-APACHE-2.0.txt"
|
||||
date_added: 2026-07-01
|
||||
license: Apache-2.0
|
||||
license_source: https://github.com/maxbaluev/accreted-intelligence/blob/main/LICENSE
|
||||
---
|
||||
|
||||
# AccInt Solve
|
||||
# solve
|
||||
## When to Use
|
||||
|
||||
## Overview
|
||||
Use this skill when you need route a goal through acc's scored-memory loop via acc_act(runtime="solve"); deliberate any returned brain_frame and submit via continue.
|
||||
|
||||
AccInt is a local-first MCP memory server for coding agents. It keeps a scored
|
||||
record of retrieved experience, open commitments, continuation frames, and
|
||||
outcome feedback so the next agent run can build on what actually worked.
|
||||
|
||||
Use this skill when AccInt is already configured in the host as an MCP server.
|
||||
The skill adapts AccInt's public `solve` Claude skill into a host-agnostic
|
||||
workflow for Claude Code, Codex CLI, Cursor, Gemini CLI, OpenCode, and other
|
||||
agent runtimes that can call MCP tools.
|
||||
Routing sugar over the two MCP verbs — no logic lives here.
|
||||
|
||||
## When to Use This Skill
|
||||
|
||||
- Use when starting non-trivial coding-agent work where prior decisions,
|
||||
debugging history, repo-specific habits, or maintainer feedback may matter.
|
||||
- Use when a task may require multiple attempts and you want an explicit
|
||||
commitment ID that can later receive a real outcome.
|
||||
- Use when AccInt returns a continuation frame and the agent must reason locally
|
||||
before submitting a proposal back to the memory loop.
|
||||
- Use after verification, merge, deployment, maintainer response, or other
|
||||
reality signal to close the commitment with an honest outcome.
|
||||
- Do not use when the host has no AccInt MCP tools configured; first install or
|
||||
configure AccInt, then rerun the workflow.
|
||||
|
||||
## How It Works
|
||||
|
||||
### Step 1: Confirm the AccInt MCP tools exist
|
||||
|
||||
Use the host's available MCP/tool list to confirm an AccInt server exposes the
|
||||
two verbs:
|
||||
|
||||
```text
|
||||
acc_retrieve(query)
|
||||
acc_act(runtime, input)
|
||||
```
|
||||
|
||||
If the host names the tools with a namespace prefix, use the equivalent
|
||||
AccInt MCP verbs. If neither verb is available, stop and ask the user to
|
||||
configure AccInt rather than inventing memory results.
|
||||
|
||||
### Step 2: Retrieve before planning
|
||||
|
||||
Before a non-trivial step, retrieve relevant prior work:
|
||||
|
||||
```json
|
||||
{"query": "the concrete task or subtask you are about to perform"}
|
||||
```
|
||||
|
||||
Read the returned memories and cite the `[ids]` you actually build on. Treat
|
||||
retrieved memories as evidence to consider, not as a substitute for inspecting
|
||||
the current repository, running tests, or checking live external state.
|
||||
|
||||
### Step 3: Route the goal through `solve`
|
||||
|
||||
Open an AccInt commitment for the concrete goal:
|
||||
|
||||
```json
|
||||
{"runtime": "solve", "input": "the concrete goal to accomplish"}
|
||||
```
|
||||
|
||||
If the response is final, use the answer, commitment ID, and cited memory IDs.
|
||||
If the response is a `brain_frame`, keep the reasoning in the current session:
|
||||
inspect the frame, resolve the missing judgment or knowledge from the workspace,
|
||||
then submit a concise proposal through `continue`.
|
||||
|
||||
### Step 4: Resolve continuation frames
|
||||
|
||||
For a returned frame, submit only the frame ID and your proposal text unless the
|
||||
host explicitly manages tokens for you:
|
||||
|
||||
```json
|
||||
{
|
||||
"runtime": "continue",
|
||||
"input": {
|
||||
"frame_id": "bf_...",
|
||||
"proposal_text": "reasoned answer, plan, or decision grounded in the current evidence"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Do not leave a received frame unresolved. If the frame expires, close or rerun
|
||||
the bound commitment rather than pretending the continuation succeeded.
|
||||
|
||||
### Step 5: Execute and verify outside AccInt
|
||||
|
||||
Do the actual work in the repository, browser, shell, issue tracker, or other
|
||||
real environment. Verify with the strongest relevant evidence available: tests,
|
||||
builds, linters, link checks, PR state, screenshots, maintainer replies, or
|
||||
production telemetry.
|
||||
|
||||
AccInt stores the learning loop; it does not replace the work or the evidence.
|
||||
|
||||
### Step 6: Close the commitment with an outcome
|
||||
|
||||
When reality answers, record the result:
|
||||
|
||||
```json
|
||||
{
|
||||
"runtime": "outcome",
|
||||
"input": {
|
||||
"ref": "solved:...",
|
||||
"good": true,
|
||||
"note": "brief evidence: tests passed, PR merged, deploy succeeded, reviewer accepted, or exact failure reason"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Use `good: false` when the approach failed. Do not tag an outcome as external
|
||||
or owner-validated unless a real external system or the owner actually supplied
|
||||
that verdict.
|
||||
|
||||
## Examples
|
||||
|
||||
### Example 1: Start a repository fix with memory
|
||||
|
||||
```text
|
||||
1. acc_retrieve({"query":"fix failing parser tests in this repo"})
|
||||
2. Read the returned memories; cite only the relevant [ids].
|
||||
3. acc_act(runtime="solve", input="Fix the failing parser tests and verify them")
|
||||
4. Inspect the repo, edit files, run the parser tests.
|
||||
5. acc_act(runtime="outcome", input={"ref":"solved:...", "good":true, "note":"parser test command passed"})
|
||||
```
|
||||
|
||||
### Example 2: Handle a continuation frame
|
||||
|
||||
```text
|
||||
AccInt returns frame bf_123 asking for a judgment about whether to patch the
|
||||
schema or the caller.
|
||||
|
||||
1. Inspect the schema and caller in the current repo.
|
||||
2. Decide from code evidence, not memory alone.
|
||||
3. acc_act(runtime="continue", input={"frame_id":"bf_123", "proposal_text":"Patch the caller because..."})
|
||||
4. Continue implementation and verification.
|
||||
```
|
||||
|
||||
## Best Practices
|
||||
|
||||
- Cite retrieved `[ids]` whenever they shape your plan or answer.
|
||||
- Keep owner-held facts owner-held: ask instead of fabricating preferences,
|
||||
credentials, identity, or history the repository cannot prove.
|
||||
- Use small, concrete solve goals; open a new solve for materially different
|
||||
subproblems instead of overloading one commitment.
|
||||
- Close commitments promptly when reality answers, including failures.
|
||||
- Record evidence in outcome notes, not confidence.
|
||||
- Preserve privacy: do not store secrets, raw credentials, or unnecessary
|
||||
sensitive user data in outcome notes.
|
||||
1. Call `acc_act(runtime="solve", input="<the goal>")`.
|
||||
2. If the result is **final**: surface the answer, the `commitment` id, and the cited `[ids]`.
|
||||
3. If the result is a **brain_frame**: it is YOUR deliberation turn — the frame is typed
|
||||
(which hole, what was retrieved, what is predicted). Reason over it, then submit via
|
||||
`acc_act(runtime="continue", input={"frame_id": ..., "submit_token": ..., "proposal_text": ...})`.
|
||||
4. End `proposal_text` with `PREDICT: <0.00-1.00> <why>`; acc strips that line before
|
||||
the owner sees it and uses it to calibrate the Work Model against later outcomes.
|
||||
5. Never leave a received frame unresolved; never solo-derive outside the loop.
|
||||
6. Close the commitment honestly later with `acc_act(runtime="outcome", ...)`.
|
||||
|
||||
## Limitations
|
||||
|
||||
- Requires an installed and configured AccInt MCP server exposing
|
||||
`acc_retrieve` and `acc_act`.
|
||||
- Does not replace repository inspection, tests, review, or live-state checks.
|
||||
- Retrieved memory can be stale or wrong; current evidence wins.
|
||||
- Outcome credit is only as strong as the evidence tier. Self-graded outcomes
|
||||
are weaker than runtime, external, or owner-validated outcomes.
|
||||
- AccInt is local-first; a different machine or database may not have the same
|
||||
memories unless the user intentionally shares the AccInt database.
|
||||
|
||||
## Security & Safety Notes
|
||||
|
||||
- This skill does not require shell commands, network fetches, or credentials.
|
||||
- AccInt MCP calls can write to the configured local AccInt database by opening
|
||||
commitments, continuations, and outcomes. Treat those writes as project
|
||||
memory, and avoid recording sensitive data that does not need to persist.
|
||||
- If a task involves production systems, payments, private accounts, legal or
|
||||
medical facts, or secrets, get the required authorization and verify against
|
||||
the appropriate external source before recording an outcome.
|
||||
|
||||
## Common Pitfalls
|
||||
|
||||
- **Problem:** Using retrieved memory as if it were guaranteed current.
|
||||
**Solution:** Use it to guide investigation, then verify in the current
|
||||
workspace or live system.
|
||||
- **Problem:** Leaving a `brain_frame` open because implementation work started.
|
||||
**Solution:** Submit a `continue` proposal first, or close/rerun the bound
|
||||
commitment if the frame expires.
|
||||
- **Problem:** Marking an outcome good before tests, checks, or external state
|
||||
prove it.
|
||||
**Solution:** Wait for real evidence, then record the outcome with the exact
|
||||
command, PR state, deploy state, or reviewer signal.
|
||||
|
||||
## Related Skills
|
||||
|
||||
- `@agent-memory-mcp` - Use when you need a broader overview of MCP-backed
|
||||
agent memory systems.
|
||||
- `@verification-before-completion` - Use before claiming work is complete.
|
||||
- `@lint-and-validate` - Use to select and run repository validation commands.
|
||||
- Use this skill only when the task clearly matches its upstream source and local project context.
|
||||
- Verify commands, generated code, dependencies, credentials, and external service behavior before applying changes.
|
||||
- Do not treat examples as a substitute for environment-specific tests, security review, or user approval for destructive or costly actions.
|
||||
|
||||
Reference in New Issue
Block a user