Extending Loopy

.claude/skills/my-conventions/SKILL.md

---
name: my-conventions
description: Team coding conventions for our Spring Boot services
---

# Instructions

When working on this codebase:
- Use constructor injection, never field injection
- All REST endpoints return ProblemDetail for errors (RFC 9457)
- Tests use @WebMvcTest with MockMvc, not @SpringBootTest
- Entity IDs are UUIDs, never auto-increment

/skills search testing
/skills info systematic-debugging
/skills add systematic-debugging

my-skills.jar
└── META-INF/skills/
    └── my-org/my-repo/api-design/
        └── SKILL.md

.claude/commands/review.md

---
name: review
description: "Code review the current diff"
---

Review the staged changes (`git diff --cached`). For each file:

1. Check for bugs, security issues, and performance problems
2. Verify test coverage for new code paths
3. Flag any style violations

Summarize findings as a table. $ARGUMENTS

---
name: test-runner
description: Runs tests and reports pass/fail summary
tools: Bash, Read
---

You are a testing specialist. When invoked:

1. Run `./mvnw test` in the working directory
2. Parse output for pass/fail/skip counts
3. If tests fail, read the relevant test source files
4. Report a concise summary: what passed, what failed, and why

public class DatabaseToolProfile implements ToolProfileContributor {

    @Override
    public String profileName() {
        return "database-tools";
    }

    @Override
    public List<ToolCallback> tools(ToolFactoryContext ctx) {
        return List.of(
            ToolCallbacks.from(new QueryTool(ctx.workingDirectory())),
            ToolCallbacks.from(new SchemaTool(ctx.workingDirectory()))
        );
    }
}

com.example.tools.DatabaseToolProfile

public class CostTracker implements ToolCallListener {

    @Override
    public void onToolExecutionCompleted(String runId, int turn,
            AssistantMessage.ToolCall toolCall, String result,
            Duration duration) {
        log.info("Tool {} took {}ms", toolCall.name(), duration.toMillis());
    }
}

public class ProgressReporter implements AgentLoopListener {

    @Override
    public void onLoopCompleted(String runId, LoopState state,
            TerminationReason reason) {
        System.err.printf("Done: %s (%d turns)%n", reason, state.turns());
    }
}

var agent = MiniAgent.builder()
    .config(config)
    .model(chatModel)
    .toolCallListener(new CostTracker())
    .loopListener(new ProgressReporter())
    .build();

LoopyAgent agent = LoopyAgent.builder()
    .workingDirectory(Path.of("/path/to/project"))
    .build();

LoopyResult result = agent.run("add input validation to UserController");

LoopyAgent agent = LoopyAgent.builder()
    .workingDirectory(workspace)
    .maxTurns(80)
    .build();

agent.run("plan a refactoring of the service layer");
agent.run("now execute the plan");  // sees the previous conversation

LoopyAgent agent = LoopyAgent.builder()
    .baseUrl("http://localhost:1234/v1")
    .apiKey("lm-studio")
    .model("local-model")
    .workingDirectory(workspace)
    .build();