Updated readme.md + Switched to HTTPS Sync

Author: StanBarrows

.gitignore

@@ -1,6 +1,8 @@
 # Dependencies
 vendor/*
 vendor/
+guidelines/
+
 node_modules/
 
 # Composer

README.md

@@ -1,23 +1,14 @@
 # codebar Solutions AG Coding Guidelines
 
-Shared Laravel AI coding guidelines and skills for codebar-ag projects. A Boost-first Composer package that ships 36 skills for consistent conventions across PHP, Laravel, testing, frontend, and services.
+Shared Laravel coding guidelines and skills for codebar-ag projects. A Composer package that ships 36 skills for consistent conventions across PHP, Laravel, testing, frontend, and services.
 
 **Rule index:** See [RULES.md](RULES.md) for the full rule structure and file reference.
 
 ---
 
-## CI
-
-GitHub Actions run on push and pull requests:
-
-- **CI workflow** — Composer validate, PHP syntax check, skill structure validation (frontmatter, count)
-- **Skill Integration** — AI-powered verification: one test prompt per skill (36 total), sends to GitHub Models, validates responses follow guidelines. Runs on prompt/skill changes, weekly schedule, and manual trigger. Requires `models: read` and GitHub Models access.
-
-Run validation locally: `composer validate-skills`
-
----
+## Skills Overview
 
-## Skills Summary
+Skills are reusable convention guides that assistants use when working with your codebase. Each skill includes Rules, Examples, Anti-Patterns, and References.
 
 | Category | Skills | Description |
 |----------|--------|-------------|
@@ -27,7 +18,7 @@ Run validation locally: `composer validate-skills`
 | **Testing** | PHPUnit, PestTesting, PHPStan, Dusk | Unit/feature tests, static analysis, browser tests |
 | **Services** | Saloon, DocuWare, Albatros | External API integrations (Saloon, DocuWare, Albatros) |
 
-**Total: 36 skills.** Each skill includes Rules, Examples, Anti-Patterns, and References.
+**Total: 36 skills.**
 
 ---
 
@@ -49,18 +40,10 @@ php artisan boost:install
 
 ### Step 2: Add this package
 
-**Option A — Composer (recommended for version pinning):**
-
 ```bash
 composer require codebar-ag/coding-guidelines --dev
 ```
 
-**Option B — GitHub via Boost:**
-
-```bash
-php artisan boost:add-skill codebar-ag/coding-guidelines
-```
-
 ### Step 3: Sync skills
 
 ```bash
@@ -71,7 +54,7 @@ Boost automatically discovers skills from `vendor/codebar-ag/coding-guidelines/r
 
 ### Step 4: Activate MCP (optional)
 
-If your editor supports MCP (Model Context Protocol), configure it to use the Boost MCP server for full context. See the [Laravel Boost documentation](https://laravel.com/docs/boost) for your editor’s setup.
+If your editor supports MCP (Model Context Protocol), configure it to use the Boost MCP server for full context. See the [Laravel Boost documentation](https://laravel.com/docs/boost) for your editor's setup.
 
 ### Step 5: Override skills locally (optional)
 
@@ -87,6 +70,18 @@ your-project/
 │           └── SKILL.md    ← Your custom version
 ```
 
+### Alternative: Sync full repo
+
+To sync the complete guidelines repo (`.github/prompts`, `RULES.md`, etc.) into a `guidelines/` directory for reference, add to your `composer.json`:
+
+```json
+"scripts": {
+    "sync-guidelines": "php vendor/codebar-ag/coding-guidelines/scripts/sync-guidelines.php"
+}
+```
+
+Then run `composer sync-guidelines`. This clones or pulls the repo into `guidelines/` at your project root.
+
 ---
 
 ## How It Works
@@ -102,15 +97,13 @@ This package places skills in `resources/boost/skills/{skill-name}/SKILL.md`. La
 
 ## Updating
 
-When using Composer:
-
 ```bash
 composer update codebar-ag/coding-guidelines
 php artisan boost:update
 ```
 
-When using `boost:add-skill`:
+---
 
-```bash
-php artisan boost:update
-```
+## CI
+
+GitHub Actions run on push and pull requests. Run validation locally: `composer validate-skills`

composer.json

@@ -1,10 +1,9 @@
 {
     "name": "codebar-ag/coding-guidelines",
-    "description": "Shared Laravel AI coding guidelines and skills for codebar-ag projects. Boost-first Composer package.",
+    "description": "Shared Laravel coding guidelines and skills for codebar-ag projects. Composer package for Laravel Boost.",
     "keywords": [
         "laravel",
         "boost",
-        "ai",
         "cursor",
         "coding-guidelines",
         "skills"
@@ -35,7 +34,8 @@
         }
     },
     "scripts": {
-        "validate-skills": "php scripts/validate-skills.php"
+        "validate-skills": "php scripts/validate-skills.php",
+        "sync-guidelines": "php scripts/sync-guidelines.php"
     },
     "config": {
         "sort-packages": true

resources/boost/skills/saloon/SKILL.md

@@ -21,7 +21,7 @@ description: Saloon-based service layer pattern for all external API integration
 - The service class wraps the connector, sends requests, and returns typed DTOs
 - Register the connector as a singleton in a service provider when needed
 - Accept an optional connector in the service constructor for testability
-- Exceptions: **Prism** is acceptable for AI/LLM integrations; inline `Http::get()` is acceptable for simple binary file downloads (not API integrations)
+- Exceptions: **Prism** is acceptable for LLM integrations; inline `Http::get()` is acceptable for simple binary file downloads (not API integrations)
 
 ## Examples
 

scripts/sync-guidelines.php

@@ -0,0 +1,31 @@
+<?php
+
+/**
+ * Sync shared coding guidelines from the codebar-ag/coding-guidelines repo.
+ *
+ * Clones (first run) or pulls (subsequent runs) the repo directly into
+ * the `guidelines/` directory at the project root.
+ *
+ * Fails gracefully if the repo is unreachable (e.g. network offline).
+ */
+$repo = 'https://github.com/codebar-ag/coding-guidelines.git';
+$targetDir = 'guidelines';
+
+if (is_dir($targetDir.'/.git')) {
+    exec("git -C {$targetDir} remote set-url origin {$repo} 2>&1", $remoteOutput, $remoteExit);
+    exec("git -C {$targetDir} fetch origin main --quiet 2>&1", $fetchOutput, $fetchExit);
+    if ($fetchExit === 0) {
+        exec("git -C {$targetDir} reset --hard FETCH_HEAD 2>&1", $resetOutput, $exitCode);
+    } else {
+        $exitCode = $fetchExit;
+    }
+} else {
+    exec("git clone --depth 1 --quiet {$repo} {$targetDir} 2>&1", $output, $exitCode);
+}
+
+if ($exitCode !== 0) {
+    echo 'Warning: Could not sync guidelines (repo not accessible).'.PHP_EOL;
+    exit(0); // Don't break composer install
+}
+
+echo "Guidelines synced to {$targetDir}/.".PHP_EOL;