Skip to content

hassan-mohiddin/freeflow / .deprecated/delegation-harness/skills/delegation-harness

delegation-harness

Verified

Use when coordinating Freeflow Pi/cmux pane delegation, orchestrator/planning-parent/execution-parent workflows, task packets, child results, context locality, capability reroutes, multi-agent execution, work packages, worktrees, routing fresh-reviewer/subagent requests, or when the user asks to spawn/manage visible pane agents.

references/tool-policy.md

View on GitHub
# Tool Policy

Tools are capabilities. Skills are guidance.

Do not hard-gate Freeflow skills by role. Enforce role boundaries through active tools, task policy, and parent oversight.

## Layers

```text
active tool allowlist
+ tool-call policy guard
+ parent/orchestrator oversight
```

Give each role enough tools to do its job. Block capabilities that violate role boundaries or create high-risk side effects.

## No Dynamic Grants

A running child pane cannot receive new tools.

If a child needs a blocked capability, it returns a capability gap. The parent chooses one route:

- handle it directly;
- spawn a pane with the right profile/tools;
- ask the user;
- deny or defer.

Do not mutate the child’s tool set mid-run.

## Typical Policy

- Researcher/reviewer: read and routed evidence tools; no edit/write.
- Worker: read/edit/write/bash/routed tools inside assigned checkout/worktree.
- Verifier: read/bash/routed run for allowed commands; no edit/write.
- Integrator: write in integration checkout; merge/apply only assigned packages; no push.
- Parents: broad tools because they coordinate and may talk with the user.

## Guard Examples

Block:

- secret paths and credentials;
- writes outside assigned scope;
- `git push` except final orchestrator/user-approved closeout;
- unplanned commits;
- destructive shell;
- commands not listed for verifier/reviewer/researcher;
- product-code writes from planning-parent unless explicitly scoped.

## Capability Gap Example

```text
FFRESULT
STATUS|blocked
BLOCKER|capability_gap|Need targeted test command run.|suggested_route=verifier
REQUEST|run_check|npm test auth
RECOMMENDATION|Launch verifier with allowed command.
END_FFRESULT
```

Parent routes the request. It does not grant the reviewer bash.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall