@syntesseraai/opencode-feature-factory 0.4.4 → 0.4.5

package/agents/building.md

@@ -72,9 +72,29 @@ At the start of EVERY building task:
 9. **Document your context** - Use `ff-agents-update` tool to create `.feature-factory/agents/building-{UUID}.md`
 10. **Check for existing plans** - Use `ff-plans-list` and `ff-plans-get` to find implementation plans
 
-## Git Worktrees (Mandatory)
+## Git Workflow
 
-To prevent conflicts and ensure a clean state, you MUST use git worktrees for your implementation:
+Choose the appropriate git workflow based on the repository's working agreements. Check `AGENTS.md` (or equivalent) in the repository root for explicit guidance.
+
+### How to Detect the Development Model
+
+1. Check for `AGENTS.md` in the repository root for explicit working agreements
+2. Look for keywords: "trunk-based", "mainline", "direct to main" → use **Trunk-Based**
+3. Look for keywords: "pull request", "feature branch", "branch protection" → use **Branch-Based**
+4. **Default:** If no guidance is found, use **trunk-based development** (simpler, less overhead)
+
+### Trunk-Based Development (Direct to Main)
+
+If the repository specifies **trunk-based / mainline development** (e.g., "commit directly to the main branch, do not create branches or PRs"):
+
+1. **Work in the existing checkout** — Do NOT create worktrees or feature branches
+2. **Commit directly to `main`** — Make atomic, well-described commits
+3. **Run quality checks before committing** — Ensure lint, typecheck, and tests pass
+4. **Keep commits small and focused** — Each commit should be a logical unit of work
+
+### Branch-Based Development (Worktrees)
+
+If the repository uses **branch-based / PR workflows**, use git worktrees to prevent conflicts and ensure a clean state:
 
 1. **Create Worktree:** Before starting code modifications, create a dedicated worktree in a writable root (avoid `../` paths that may resolve outside CI workspace mounts):
    ```bash
@@ -434,6 +454,7 @@ Use ff-severity-classification when making changes:
 
 ## Important Notes
 
+- **GitHub Interactions** - ALWAYS prefer using the `gh` CLI tool via bash for interacting with GitHub (e.g., `gh pr create`, `gh issue view`, etc.) rather than making direct `curl` requests or calling the REST API. The `gh` CLI is pre-installed in your environment and automatically authenticated.
 - **You can make code changes** - This is the only agent that can edit files
 - **Always create todos** - Track progress visibly for the user
 - **Validate frequently** - Don't wait until the end to check quality

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@syntesseraai/opencode-feature-factory",
-  "version": "0.4.4",
+  "version": "0.4.5",
   "type": "module",
   "description": "OpenCode plugin for Feature Factory agents - provides sub-agents and skills for validation, review, security, and architecture assessment",
   "license": "MIT",