SwiftRelay

← Toutes les notes de sprint

Keep Your Coding Assistant Focused, One Task at a Time

Démarrage express avec les agentsEN

A coding assistant can lose focus when a request mixes a bug fix, a refactor, and a feature idea. The problem is not always the model. Sometimes the assignment has no clear boundary. Treat each interaction as a small engineering ticket: one outcome, explicit constraints, and a checkable finish line.

Here is a repeatable walkthrough for turning a broad request into focused, reviewable work.

1. Turn the broad request into one observable outcome

Start by describing what should change for a user or caller, not everything you want improved. “Clean up authentication” leaves too many decisions open. “Reject expired password-reset tokens before updating the password” gives the assistant a concrete target.

Write a single sentence that defines success. If that sentence needs several unrelated clauses, split the assignment. Keep cleanup ideas in a separate list rather than adding them to the current prompt.

2. Ask for a narrow inspection before allowing edits

When you do not know where the behavior lives, make investigation its own task. Ask the assistant to locate the relevant handler, token validation helper, and existing tests. Request file paths and a short explanation, with no changes yet.

Example prompt: “Find where password-reset token expiry is checked. Inspect the reset handler and its direct dependencies only. Report the relevant files, current behavior, and smallest likely fix. Do not edit files.”

This creates a checkpoint before an uncertain diagnosis becomes a patch.

3. Name the allowed files and forbidden changes

Use the inspection results to define the editing boundary. Name the files the assistant may change and the interfaces it must preserve. Avoid an arbitrary file limit when the fix genuinely requires another file; instead, require the assistant to explain any expansion before proceeding.

  • Allowed: the reset handler and its existing test file.
  • Preserve: public function signatures and the response format.
  • Exclude: dependency upgrades, formatting sweeps, and unrelated authentication cleanup.

These boundaries distinguish necessary implementation work from tempting improvements that belong in another task.

4. Define acceptance checks before requesting implementation

Tell the assistant how you will judge the result. For the reset-token example, specify that an expired token must be rejected, a valid token must still work, and rejection must leave the stored password unchanged.

Ask it to follow existing test conventions and run the relevant test command. If it cannot execute tests, require a clear statement of that limitation. An implementation is not verified merely because the assistant describes it confidently.

Example prompt: “Implement only the expiry fix. Add regression coverage for the expired-token case and preserve valid-token behavior. Run the targeted tests and report the command, result, and any unverified checks.”

5. Review the patch before assigning the next task

Read the diff while the intended change is still easy to hold in your head. Check whether every changed line supports the acceptance criteria. Look for incidental renaming, altered error handling, or newly introduced abstractions.

If the assistant discovers a separate defect, record it rather than quietly widening the assignment. Ask for a brief handoff: what changed, what was tested, and what remains unresolved. Commit or otherwise preserve the reviewed patch before starting another task.

6. Reset context when the objective changes

A long conversation can accumulate abandoned approaches and conflicting instructions. Start a fresh session when moving to a different feature or subsystem, carrying forward only the facts needed for that assignment.

Include the current objective, relevant files, constraints, and verified decisions. Do not paste the entire previous conversation. If you use different models for inspection and implementation, preserve the same task contract so the handoff does not reopen settled scope.

7. Keep tool flexibility separate from task scope

SwiftRelay fits naturally when you want model access through tools such as Claude Code, Codex, Gemini CLI, or an OpenAI-compatible SDK. Its per-token billing lets you use it on a pay-as-you-go basis. Keep the engineering workflow unchanged: inspect narrowly, authorize a bounded edit, and verify the result.

Sign up for SwiftRelay when you are ready to try that workflow with your preferred supported tool. Begin with one real bug and one acceptance check—not a repository-wide makeover.

The habit to keep is simple: give the assistant less to interpret and something precise to finish.

Pour le tour suivant

De retour pour un nouveau tour ?Se connecter