How autonomous development works at TaskShipyard
The whole pipeline, from the moment you tag an issue to the moment you merge. Five steps, no chat window.
1. Tag an issue with @taskship
Install the GitHub App on the repositories you want covered, then mention @taskship in an issue or in a comment on one. TaskShipyard creates a run for that issue and queues it against your tenant. Tagging the same issue twice does not start a second run.
2. A dev seat picks the run up
A seat is a numbered slot that owns a cloud stage. A machine claims the run, binds to your tenant, clones the repository onto a branch named after the issue, installs dependencies, resets a local database from your migrations and starts the dev servers.
If no machine is warm, the fleet starts one; if a seat already serves your tenant, it takes the work so the checkout stays warm.
3. The agent works one feature
One run, one feature. The agent has the issue, the repository, the running stack, a browser it can screenshot, and scoped cloud credentials. It commits as it goes.
4. It has to prove the work
A run is not finished when the code compiles. The agent has to show a screenshot of every screen it touched, real API responses including the failure cases, the cloud resources it created, and the database rows its feature writes — and the repository’s typecheck and tests have to pass.
5. Pull requests and AI agent preview environments
The run pushes the branch, opens a pull request whose body is the agent’s own summary and verification write-up, posts that write-up back on the issue, and reports the still-running stack as an AI agent preview environment. You click through the live app, then merge or close it like any other pull request.
Limits worth knowing today
One stack is supported end to end — React on the front, SST and AWS Lambda for the backend, Postgres through Supabase. One issue becomes one run. Production deploys stay a human action.
Questions we get asked
- Which repositories can TaskShipyard see?
- Only the ones you grant the GitHub App, and a run only ever holds a token for the single repository it is working in.
- What happens if a run runs out of budget mid-feature?
- It pauses and resumes on the same branch rather than failing. The pull request keeps its history.
- Can I trigger a run without an issue?
- Yes — the dashboard can start one directly, but the issue remains the best place to describe the work.