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(4mo ago)12219.2k↑11.5%4[1 issues](https://github.com/mischasigtermans/laravel-altitude/issues)MITPHPPHP ^8.2CI passing

Since Jan 3Pushed 4mo 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 2w 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

45

—

FairBetter than 91% of packages

Maintenance73

Regular maintenance activity

Popularity43

Moderate usage in the ecosystem

Community11

Small or concentrated contributor base

Maturity41

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

149d 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

[tomshaw/electricgrid

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

119.8k](/packages/tomshaw-electricgrid)[builtbyberry/laravel-swarm

Multi-agent swarm orchestration for Laravel, built on Laravel AI.

323.3k7](/packages/builtbyberry-laravel-swarm)[forjedio/inertia-table

Backend-driven dynamic tables for Laravel + Inertia.js

272.0k](/packages/forjedio-inertia-table)

PHPackages © 2026

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