framework copilot-instructions.md

Copilot instructions for phenixphp/framework, covering phenix framework ai instructions, core architecture, async-first design, application bootstrap and dependency container pattern.

Instructions file for GitHub Copilot

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/phenixphp/framework/copilot-instructions
Clone the repo
git clone --depth 1 https://github.com/phenixphp/framework

Made for: GitHub Copilot.

Per session 1,059 This file is loaded in full into every session.
When invoked 1,059 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin unknown No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.01059 $0.01059
Opus 5 $0.00530 $0.00530
Sonnet 5 $0.00212 $0.00212
Haiku 4.5 $0.00106 $0.00106

Measured today against content hash 772c9b669403, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

framework copilot-instructions.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured today.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.github/copilot-instructions.md · 113 lines

How it starts

The opening of the file, as written. The whole thing — 113 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Phenix Framework AI Instructions

Phenix is an async-first PHP web framework built on Amphp v3 for high-performance applications. This guide helps AI agents understand the framework's unique patterns and architecture. Phenix is an asynchronous PHP web framework built on the AmPHP ecosystem. It serves as the core framework for building scalable, async-first API applications. Official documentation can be found at Phenix Documentation.

Core Architecture

Async-First Design

  • Framework runs in CLI SAPI with its own HTTP server using SocketHttpServer
  • All I/O operations are non-blocking using Amphp primitives
  • Use App::make() for dependency resolution throughout the codebase
  • Service providers register dependencies in App::setup() method

Application Bootstrap

// Standard app creation pattern
$app = AppBuilder::build($path, $env);
$app->run(); // Starts HTTP server and handles signals

Dependency Container Pattern

  • Uses League Container with service providers for registration
  • Access via App::make(ClassName::class) static method
  • Register services: $app->register(Key::class, $concrete)
  • Facades provide static access: Config::get('key'), Route::get('/path')

Key Components

Routing System (src/Routing/)

  • Fluent route builder: Route::get('/users', $handler)->middleware($middleware)
  • Groups support: Route::group(fn() => Route::get('/admin', $handler))
  • Automatic dependency injection in route handlers
  • Middleware stacking via stackMiddleware()

Queue System (src/Queue/) - Current Development Focus

  • Abstract QueuableTask base class for background jobs
  • Multiple drivers: RedisQueue, DatabaseQueue, ParallelQueue
  • Tasks use ShouldQueue interface and enqueue() static method
  • State management with TaskState for tracking job progress

Database & Query Builder (src/Database/)

  • Async database operations using Amphp MySQL/PostgreSQL drivers
  • Fluent query builder with method chaining
  • Connection factory pattern for multiple database connections
  • Migration system with console commands

Read the full file on GitHub · 113 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. today First seen · 113 lines · 1,059 tokens per session scan A 772c9b669403

Subscribe to this mod's changes

framework copilot-instructions.md is an instructions file published in the GitHub repository phenixphp/framework (13 stars, last pushed 2mo ago), licensed MIT. It adds 1,059 tokens to every session, about $0.0053 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-02.

Related

Other instructions, from other repositories

the-seo-framework copilot-instructions.md

Copilot instructions for sybrew/the-seo-framework, covering repository-specific rules, repository-specific work types, file management, response style and general operating rules.

sybrew/the-seo-framework · 2,597 tokens

the-seo-framework php.instructions.md

Use when editing PHP, WordPress PHP, SQL-in-PHP, or mixed PHP and HTML template files in this repository. Covers TSF PHP style, namespace rules, SQL formatting, and template formatting.

sybrew/the-seo-framework · 1,592 tokens

the-seo-framework docs.instructions.md

Use when editing README.md, readme.txt, or other user-facing documentation for this repository. Covers readme wording constraints, WordPress readme format, changelog prose style, and public API naming requirements.

sybrew/the-seo-framework · 639 tokens

the-seo-framework local.instructions.md

Use when handling local-only workspace guidance, private support materials, related-repository cross-references, remediation, troubleshooting, reproduction, triage, or customer-facing diagnosis that may require code changes.

sybrew/the-seo-framework · 595 tokens

the-seo-framework javascript.instructions.md

Use when editing JavaScript files in this repository. Covers TSF JavaScript syntax and formatting expectations.

sybrew/the-seo-framework · 469 tokens

the-seo-framework css.instructions.md

Use when editing CSS files in this repository. Covers TSF stylesheet conventions and layout-debugging expectations.

sybrew/the-seo-framework · 115 tokens