Skip to content

chore: add PassionFactory standard dev tooling setup#8

Merged
amondnet merged 1 commit into
mainfrom
chore/add-dev-tooling-setup
Jun 8, 2026
Merged

chore: add PassionFactory standard dev tooling setup#8
amondnet merged 1 commit into
mainfrom
chore/add-dev-tooling-setup

Conversation

@amondnet

@amondnet amondnet commented Jun 8, 2026

Copy link
Copy Markdown
Contributor

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 the modern-web-guidance plugin from the pleaseai marketplace so Claude Code has the correct toolset when working in this repo.
  • orca.yaml — Orca worktree setup script: runs mise trust/mise 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) are propagated from the main checkout into Orca worktrees.

Note: .claude/settings.local.json is an absolute symlink to the pleaseai/oss shared settings. It is excluded via .git/info/exclude and is intentionally not committed here.

Test Plan

  • Verify gh please and Claude Code operate correctly after the plugin is enabled (.claude/settings.json)
  • Confirm a new Orca worktree runs the setup script without errors (orca.yaml)
  • Confirm .worktreeinclude entries are present for local env files

Related 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, run bun install), and .worktreeinclude rules to sync .env* and .claude/settings.local.json.

Written for commit a37f260. Summary will update on new commits.

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.
@codacy-production

Copy link
Copy Markdown

Up to standards ✅

🟢 Issues 0 issues

Results:
0 new issues

View in Codacy

AI Reviewer: first review requested successfully. AI can make mistakes. Always validate suggestions.

Run reviewer

TIP This summary will be updated as you push new changes.

@sonarqubecloud

sonarqubecloud Bot commented Jun 8, 2026

Copy link
Copy Markdown

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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
Loading

Re-trigger cubic

@amondnet amondnet merged commit bca53c1 into main Jun 8, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant