Appearance
Development guide
Bipole uses project instructions, decision records, automated checks, and maintainer review for agent-assisted development. The records describe the current implementation and the reasons for its design. The source code establishes current behavior when an older record differs from it.
Use these procedures:
| Task | Procedure |
|---|---|
| Start and implement a change | Task procedure |
| Prepare an independent task environment | Git worktrees |
| Select and do checks | Verification |
| Evaluate AI operations and routes | AI evaluation |
| Examine a diff or prepare a pull request | Review |
| Find a project term | Glossary |
| Find components, data, or interfaces | Architecture inventory |
| Record a design choice | Architecture decision records |
| Record user-visible behavior | Feature decision records |
| Write release notes | Release index |
| Record a service incident | Incident index |
Source approach
Hendrik Mans describes the workflow in Chatto is Robots. His Chatto repository shows skills, decision records, and review procedures in use. Bipole uses these ideas with its existing React, PocketBase, Yjs, and npm tools.
AI Makes Better Software describes how saved development time can support better design. The Bipole procedure requires an expected improvement and evidence for substantial design changes. This requirement gives the maintainer a basis for a decision beyond development speed.
The local simple-english skill adapts SimpleEnglish 2.0.2 at commit 6fa7943df766d73000b6ef8a184b012ac72b136e. Its source record and MIT license are in .agents/skills/simple-english/. Use its Strict mode rules for new or changed English prose.
Agent access
AGENTS.md selects the skills for each task. OpenCode reads .agents/skills/ through opencode.json. CLAUDE.md refers Claude Code to the same project instructions. An agent without a skill loader can read each SKILL.md directly.
OpenCode also provides /plan-change and /review-change commands in this repository. Start a separate session before /review-change when you want an independent agent review. Quit and restart OpenCode after changes to its configuration, skills, or command files.