M MortelOS Docs

Version 0

MortelOS Dev Tools

Developer tooling for MortelOS package decisions and governance checks.

mortelos/dev-tools provides developer tooling for package-ready feature decisions.

Use It For

Area Package responsibility
Decision logging Record whether a feature is package-now, package-ready or workspace-only.
Governance checks Validate package decision logs locally or in CI.
Agent rules Publish and check merged agent rules for package-aware development.
Workflow support Keep package boundaries explicit before implementation starts.

Install

composer require mortelos/dev-tools --dev

Commands

php artisan mortelos:package-decision "Customer Portal" \
  --decision=package-ready \
  --surface=mortelos/customer-portal \
  --reason="Reusable shell with customer-specific tenant policy and branding."

php artisan mortelos:package-decisions:check --require-reason
php artisan mortelos:agent-rules:publish
php artisan mortelos:agent-rules:check

Composer Hook

Host apps should regenerate package agent rules after Composer updates, similar to Laravel Boost package discovery hooks:

{
  "scripts": {
    "post-autoload-dump": [
      "@php artisan package:discover --ansi",
      "@php artisan mortelos:agent-rules:publish --target=AGENTS.md --no-interaction"
    ]
  }
}

Keep host-specific instructions outside the generated block. Manual edits inside the generated block are overwritten.

Boundaries

Use this package for development workflow and governance. It does not own runtime portal behavior.