chore: add PassionFactory standard dev tooling setup#8
Merged
Conversation
Add the three configuration files that wire this repo into the shared PassionFactory developer workflow: - .claude/settings.json: enables the modern-web-guidance plugin from the pleaseai marketplace so Claude Code has the right toolset when working in this repo. - orca.yaml: Orca worktree setup script that runs mise trust/install, copies gitignored local files via @pleaseai/worktreeinclude, and runs bun install in each new worktree. - .worktreeinclude: declares which gitignored files (.env*, .claude/settings.local.json) should be propagated from the main checkout into Orca worktrees. Note: .claude/settings.local.json is a symlink to the pleaseai/oss shared settings and is intentionally excluded via .git/info/exclude — it is not tracked here.
Up to standards ✅🟢 Issues
|
|
There was a problem hiding this comment.
No issues found across 3 files
Architecture diagram
sequenceDiagram
participant Dev as Developer
participant Orca as Orca Worktree System
participant Mise as mise Tool Manager
participant Claude as Claude Code
participant Worktree as New Worktree
Note over Dev,Worktree: NEW: Orca Worktree Creation Flow
Dev->>Orca: Create new worktree
Orca->>Orca: Read orca.yaml scripts.setup
Orca->>Worktree: Set $ORCA_ROOT_PATH & $ORCA_WORKTREE_PATH
Note over Worktree,Mise: Step 1: Trust mise config
Orca->>Mise: mise trust --quiet
Mise-->>Orca: Confirm trust
Note over Worktree,Mise: Step 2: Install declared tools
Orca->>Mise: mise install
Mise->>Mise: Install java, gradle, flutter, bun
Mise-->>Orca: Tools installed
Note over Worktree,Claude: Step 3: Sync gitignored files
Orca->>Orca: mis exec -- bunx @pleaseai/worktreeinclude
Orca->>Worktree: Read .worktreeinclude
Worktree-->>Orca: Patterns: .env, .env.local, .env.*.local, .claude/settings.local.json
alt Files exist in root checkout
Orca->>Worktree: Copy matching files from $ORCA_ROOT_PATH to $ORCA_WORKTREE_PATH
Worktree-->>Orca: Files synced
else No gitignored files
Orca->>Worktree: No copies needed
end
Note over Worktree: Step 4: Install dependencies
Orca->>Orca: mise exec -- bun install
Orca->>Worktree: Install project dependencies
Worktree-->>Orca: Dependencies installed
Orca-->>Dev: Worktree ready
Note over Dev,Claude: NEW: Claude Code Plugin Configuration
Dev->>Claude: Claude Code in worktree
Claude->>Claude: Read .claude/settings.json
Claude->>Claude: Enable modern-web-guidance@pleaseai plugin
Claude->>Claude: Register pleaseai marketplace from github.com/pleaseai/claude-code-plugins
Claude->>Claude: Load plugin toolset
Claude-->>Dev: Enhanced tooling available
Note over Dev: Local settings (optional)
opt settings.local.json exists
Claude->>Claude: Merge .claude/settings.local.json overrides
Claude-->>Dev: Applied local overrides
end
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.



Summary
Add the three configuration files that wire this repository into the shared PassionFactory developer workflow, following the conventions established in pleaseai/oss.
Changes
.claude/settings.json— enables themodern-web-guidanceplugin from thepleaseaimarketplace so Claude Code has the correct toolset when working in this repo.orca.yaml— Orca worktree setup script: runsmise trust/mise install, copies gitignored local files via@pleaseai/worktreeinclude, and runsbun installin each new worktree..worktreeinclude— declares which gitignored files (.env*,.claude/settings.local.json) are propagated from the main checkout into Orca worktrees.Test Plan
gh pleaseand Claude Code operate correctly after the plugin is enabled (.claude/settings.json)orca.yaml).worktreeincludeentries are present for local env filesRelated Issues
N/A — initial dev tooling configuration.
Summary by cubic
Sets up PassionFactory standard dev tooling for consistent local and Orca worktree workflows. Adds Claude Code plugin config, an Orca setup script (trust/install
mise, copy gitignored files with@pleaseai/worktreeinclude, runbun install), and.worktreeincluderules to sync.env*and.claude/settings.local.json.Written for commit a37f260. Summary will update on new commits.