Snider 9600277897 feat: add .core/ bridge system for fresh developer onboarding

Introduces a .core/ folder structure that provides:
- workspace.yaml for active package configuration
- Claude Code plugin with skills for multi-repo navigation
- Hook script suggesting core CLI over raw commands
- Full .core/ folder specification for other packages

Also restructures README.md and CLAUDE.md for better fresh
developer experience with clear "what happens" and "what's next"
sections.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-01-31 18:41:23 +00:00

1.7 KiB

Raw Permalink Blame History

Switch Package Skill

Switch the active package for the Host UK workspace.

Usage

To switch the active package, edit .core/workspace.yaml and change the active field:

# .core/workspace.yaml
active: core-tenant  # Change this to the desired package

Available Packages

Package	Type	Description
`core-php`	foundation	Core PHP framework
`core-tenant`	module	Multi-tenancy, workspaces
`core-admin`	module	Admin panel, Livewire
`core-api`	module	REST API, rate limiting
`core-mcp`	module	MCP server framework
`core-agentic`	module	AI agent orchestration
`core-bio`	product	Link-in-bio pages
`core-social`	product	Social media scheduling
`core-analytics`	product	Privacy-first analytics
`core-notify`	product	Push notifications
`core-trust`	product	Social proof widgets
`core-support`	product	Helpdesk, tickets
`core-commerce`	module	Billing, Stripe
`core-content`	module	CMS, pages, blog
`core-tools`	module	Developer utilities
`core-uptelligence`	module	Server monitoring
`core-developer`	module	Developer portal
`core-template`	template	Starter template

After Switching

After changing the active package:

Commands like core php test will target the new package
Read the package's CLAUDE.md for specific guidance: packages/{package}/CLAUDE.md
Install dependencies if needed: cd packages/{package} && composer install

Quick Switch (CLI - Future)

Once core workspace commands are implemented:

core workspace active core-tenant    # Switch to core-tenant
core workspace active               # Show current active package

1.7 KiB Raw Permalink Blame History