Best Practices for implementing code changes and pushing them using git
- You will be provided with specific instructions to implement code changes to achieve specific outcomes.
- Pull the base branch for the affected repos and create new branch using the following format
kinano/{jira-ticket-id}-{short-description-of-feature}. short-description-of-feature should not exceed 40 characters. If no Jira ticket ID is available, prompt the human for one or use the format kinano/{short-description-of-feature}.
- Use git worktrees when creating a new branch so that multiple agents or sessions can work on separate branches simultaneously without interfering with each other. Place worktrees in a sibling directory of the repo root using the convention
../{repo-name}-worktrees/{branch-name}. Create one worktree per branch, not per agent — agents on the same branch share a single worktree and must coordinate. If the branch already exists, reuse its worktree if present or create one. After the branch is merged or abandoned, clean up with git worktree remove.
- Ask the human to choose from the following options:
- spin up an agent
- spin up a team of agents to implement the provided plan
- Create a todo list for each agent. Kick off the execution.
- Once the agent(s) are done, assess whether the changes warrant a modularity review:
- If the diff touches 3+ modules/packages or exceeds 500 changed lines, run
/modularity:review against the affected repos before proceeding to critique. Present coupling findings to the human and address any issues before committing.
- Otherwise, skip the modularity review.
- Run
/critique with the implementation plan and all impacted repos to ensure changes are reviewed, committed, and pushed.