PHPackages                             mischasigtermans/laravel-altitude - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. mischasigtermans/laravel-altitude

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

mischasigtermans/laravel-altitude
=================================

Claude Code agents for the TALL stack, powered by Laravel Boost

v0.2.0(1mo ago)1139.2k↑54.6%4[1 issues](https://github.com/mischasigtermans/laravel-altitude/issues)MITPHPPHP ^8.2CI passing

Since Jan 3Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/mischasigtermans/laravel-altitude)[ Packagist](https://packagist.org/packages/mischasigtermans/laravel-altitude)[ RSS](/packages/mischasigtermans-laravel-altitude/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (3)Dependencies (14)Versions (5)Used By (0)

Altitude
========

[](#altitude)

[![Latest Version on Packagist](https://camo.githubusercontent.com/1b03e1310ba26704985554603e8acffc93e8bc7db12858963c8959dd970ebe72/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d69736368617369677465726d616e732f6c61726176656c2d616c7469747564652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/mischasigtermans/laravel-altitude)[![Total Downloads](https://camo.githubusercontent.com/94edf2dd8bce14b4bff98ed2a7c5d9551a276403796c9fbf8e53576f3017fe97/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6d69736368617369677465726d616e732f6c61726176656c2d616c7469747564652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/mischasigtermans/laravel-altitude)

Opinionated Claude Code agents and commands for TALL stack development.

> **Note:** This package is opinionated. It assumes you're building with the TALL stack (Tailwind, Alpine, Livewire, Laravel) and optionally Filament, Flux UI, and Pest. If you use a different stack, this package may not be for you.

Altitude provides specialized AI agents that focus on decision-making and workflow patterns while [Laravel Boost](https://laravel.com/ai/boost) handles version-specific documentation via MCP.

Installation
------------

[](#installation)

```
composer require mischasigtermans/laravel-altitude --dev
```

Quick Start
-----------

[](#quick-start)

Altitude syncs automatically when Laravel Boost runs `boost:install` or `boost:update`.

**Recommended:** Add to your `composer.json` scripts for automatic updates:

```
{
    "scripts": {
        "post-update-cmd": [
            "@php artisan boost:update --quiet"
        ]
    }
}
```

This keeps agents and documentation in sync whenever you run `composer update`.

**Manual sync:** For more control, run directly:

```
php artisan altitude:sync         # Sync new agents only
php artisan altitude:sync --force # Overwrite existing agents
```

How Syncing Works
-----------------

[](#how-syncing-works)

### On Install

[](#on-install)

When you install Altitude, agents sync automatically on the next console command if `.claude/agents` doesn't exist yet. This ensures you get agents immediately without needing to run a separate command.

### On Boost Updates

[](#on-boost-updates)

When `boost:install` or `boost:update` runs, Altitude syncs with `--force`, updating all agents to the latest versions.

### File Conflicts

[](#file-conflicts)

Altitude agents use common names like `architect`, `database`, and `livewire`. If you have custom agents with the same names, they will be overwritten on boost updates.

**To keep custom agents**, use different names:

```
.claude/agents/
├── architect.md        # Altitude (will be updated)
├── my-architect.md     # Your custom version (safe)
└── project-rules.md    # Your custom agent (safe)

```

Alternatively, disable auto-sync and manage updates manually:

```
ALTITUDE_AUTO_SYNC=false
```

Why Altitude?
-------------

[](#why-altitude)

AI assistants need context about your stack to give good advice. But documentation changes between versions, and copy-pasting docs into prompts wastes tokens and goes stale.

Altitude solves this by:

- **Separating concerns** — Agents handle decisions and workflow, Boost handles docs
- **Package-aware publishing** — Only get agents for packages you actually use
- **Workflow commands** — Common tasks like `/ship`, `/test`, `/debug` work out of the box
- **Never stale** — Agents reference `mcp__laravel-boost__search-docs` instead of embedding version-specific code

Agents
------

[](#agents)

Altitude publishes agents based on your installed packages:

### Always Included

[](#always-included)

AgentPurpose`architect`Multi-file features and architecture decisions`database`Schema design, migrations, Eloquent models`docs`Documentation lookup via MCP tools`security`Security audits and vulnerability checks### Package-Specific

[](#package-specific)

PackageAgents`livewire/livewire``livewire`, `alpine``livewire/flux``flux``filament/filament``filament``pestphp/pest``pest``laravel/reverb``realtime`### How Agents Work

[](#how-agents-work)

Each agent defines:

1. **Responsibilities** — What it handles
2. **Decision guides** — Common choices and tradeoffs
3. **Workflow** — Steps to follow
4. **References** — Points to `mcp__laravel-boost__search-docs` for implementation details

Example usage in Claude Code:

```
@architect I need to add a booking system with events, tickets, and payments

```

```
@livewire Create a component for filtering products by category

```

```
@database Design a schema for multi-tenant organizations with team members

```

Commands
--------

[](#commands)

Workflow commands are always published:

CommandPurpose`/ship`Commit, push, and create pull request`/test`Run tests related to current changes`/debug`Debug using logs and application state`/review`Review code for quality and security`/catchup`Resume work after a break`/pint`Format code with Laravel Pint### Command Examples

[](#command-examples)

```
/ship "Add user profile page"

```

```
/test --all

```

```
/debug "500 error on checkout"

```

Optional: Enhanced Debugging
----------------------------

[](#optional-enhanced-debugging)

### Herd Pro

[](#herd-pro)

If you're using [Laravel Herd Pro](https://herd.laravel.com), the `/debug` command can access logs and dumps via MCP:

ToolPurpose`mcp__herd__get-logs`Application logs`mcp__herd__get-dumps`Dump output### Telescope MCP

[](#telescope-mcp)

If you have [Laravel Telescope](https://laravel.com/docs/telescope) installed, add the MCP wrapper for Claude access:

```
composer require lucianotonet/laravel-telescope-mcp --dev
```

ToolPurpose`mcp__laravel-telescope__requests`HTTP requests with exceptions`mcp__laravel-telescope__exceptions`Stack traces and error details`mcp__laravel-telescope__queries`Slow and failed database queries`mcp__laravel-telescope__jobs`Failed queue jobs`mcp__laravel-telescope__logs`Application logs`mcp__laravel-telescope__mail`Sent emailsWithout these tools, `/debug` falls back to reading `storage/logs/laravel.log`.

What Gets Published
-------------------

[](#what-gets-published)

```
.ai/
└── guidelines/
    └── tall-stack.md          # Stack overview and conventions

.claude/
├── agents/
│   ├── alpine.md              # Alpine.js interactivity
│   ├── architect.md           # Architecture decisions
│   ├── database.md            # Schema and migrations
│   ├── docs.md                # Documentation lookup
│   ├── filament.md            # Filament admin panels
│   ├── flux.md                # Flux UI components
│   ├── livewire.md            # Livewire components
│   ├── pest.md                # Testing with Pest
│   ├── realtime.md            # WebSockets with Reverb
│   └── security.md            # Security auditing
└── commands/
    ├── catchup.md             # Resume after break
    ├── debug.md               # Debug with logs/Telescope
    ├── pint.md                # Code formatting
    ├── review.md              # Code review
    ├── ship.md                # Commit and PR workflow
    └── test.md                # Run related tests

```

Configuration
-------------

[](#configuration)

Publish the config to customize:

```
php artisan vendor:publish --tag=altitude-config
```

```
// config/altitude.php
return [
    // Disable auto-sync on boost:install/update
    'auto_sync' => env('ALTITUDE_AUTO_SYNC', true),

    // Map packages to agents
    'agents' => [
        'livewire/livewire' => ['livewire', 'alpine'],
        'livewire/flux' => ['flux'],
        'filament/filament' => ['filament'],
        'pestphp/pest' => ['pest'],
        'laravel/reverb' => ['realtime'],
    ],

    // Agents always published
    'always' => [
        'architect',
        'database',
        'docs',
        'security',
    ],

    // Commands always published
    'always_commands' => [
        'ship',
        'test',
        'debug',
        'review',
        'catchup',
        'pint',
    ],
];
```

Re-syncing
----------

[](#re-syncing)

When you add packages, re-run sync to get their agents:

```
composer require filament/filament
php artisan altitude:sync
```

Use `--force` to update existing agents with latest versions:

```
php artisan altitude:sync --force
```

Use Cases
---------

[](#use-cases)

### New Feature Development

[](#new-feature-development)

```
@architect I need to add a document management system with versioning

```

```
@livewire Create the upload component based on the architecture plan

```

### Debugging Production Issues

[](#debugging-production-issues)

```
/debug "500 error on checkout page"

```

### Code Review Before PR

[](#code-review-before-pr)

```
/review
/ship "Add document versioning"

```

### Resuming After a Break

[](#resuming-after-a-break)

```
/catchup

```

Requirements
------------

[](#requirements)

- PHP 8.2+
- Laravel 11 or 12
- [Laravel Boost](https://laravel.com/ai/boost) (installed automatically)

Credits
-------

[](#credits)

- [Mischa Sigtermans](https://github.com/mischasigtermans)

License
-------

[](#license)

MIT

###  Health Score

48

—

FairBetter than 95% of packages

Maintenance89

Actively maintained with recent releases

Popularity41

Moderate usage in the ecosystem

Community11

Small or concentrated contributor base

Maturity40

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 85.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~39 days

Total

3

Last Release

56d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/a002abdc851a76410e86443f04058710f9d32f82f31873f8c6544d2e881e79c6?d=identicon)[mischasigtermans](/maintainers/mischasigtermans)

---

Top Contributors

[![mischasigtermans](https://avatars.githubusercontent.com/u/22501510?v=4)](https://github.com/mischasigtermans "mischasigtermans (6 commits)")[![trippo](https://avatars.githubusercontent.com/u/497169?v=4)](https://github.com/trippo "trippo (1 commits)")

---

Tags

claudeclaude-agentsclaude-codeclaude-commandslaravellaravel-boosttall-stacklaravelailivewireagentsclaudetall

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/mischasigtermans-laravel-altitude/health.svg)

```
[![Health](https://phpackages.com/badges/mischasigtermans-laravel-altitude/health.svg)](https://phpackages.com/packages/mischasigtermans-laravel-altitude)
```

###  Alternatives

[bezhansalleh/filament-google-analytics

Google Analytics integration for FilamentPHP

205144.8k5](/packages/bezhansalleh-filament-google-analytics)[arm092/livewire-datatables

Advanced datatables using Laravel, Livewire, Tailwind CSS and Alpine JS

2953.8k](/packages/arm092-livewire-datatables)[gonetone/laravel-boost-windsurf-extension

Laravel Boost extension package that provides Windsurf editor and Windsurf JetBrains plugin integration.

239.1k](/packages/gonetone-laravel-boost-windsurf-extension)[anilcancakir/laravel-ai-sdk-skills

A skill system for Laravel AI SDK agents. Define reusable AI capabilities with SKILL.md files.

151.1k](/packages/anilcancakir-laravel-ai-sdk-skills)[tomshaw/electricgrid

A feature-rich Livewire package designed for projects that require dynamic, interactive data tables.

116.6k](/packages/tomshaw-electricgrid)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
