@ryuenn3123/agentic-senior-core 4.4.0 → 5.2.0

package/README.md

@@ -2,13 +2,12 @@
 
 # Agentic-Senior-Core
 
-### Change your AI Agent to code like a Staff Engineer, not a Junior.
+### Universal AI coding rules. Write code like a staff engineer, not a junior.
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
 
-**Production-grade Rules Engine for AI coding agents.**
-Works with Cursor, Windsurf, GitHub Copilot, Claude Code, Gemini, and other LLM-powered IDE workflows.
+**Install once. Works across all projects. Supports 16+ AI coding agents.**
 
 </div>
 
@@ -16,186 +15,267 @@ Works with Cursor, Windsurf, GitHub Copilot, Claude Code, Gemini, and other LLM-
 
 ## Install
 
+### Step 1: Install the package
+
 ```bash
-npx @ryuenn3123/agentic-senior-core init
+npm install -g @ryuenn3123/agentic-senior-core
 ```
 
-Initializes `AGENTS.md`, native import bridges, checklists, policies, state files, and the lazy `.agent-context/` rule library. Token optimization and Compact Natural Mode are enabled by default.
+### Step 2: Set up for your AI tool
 
-Options:
-- Add `--mcp-template` to generate VS Code MCP workspace config.
-- Default init keeps MCP files opt-in.
-- Add `--no-token-optimize` only when you do not want ASCX command guidance enabled.
-- Add `--local-only` to ignore instructions (AGENTS.md, .agent-context/, and bridges) in .gitignore so they are not pushed to GitHub.
-- Local backup snapshots are written under `.agentic-backup/` and excluded from version control.
+<details>
+<summary><b>Claude Code</b> (terminal agent)</summary>
 
-## Upgrade
+Rules load automatically via plugin hooks. No per-project files needed.
 
 ```bash
-npx @ryuenn3123/agentic-senior-core upgrade --dry-run
-npx @ryuenn3123/agentic-senior-core upgrade --yes
+claude plugin add fatidaprilian/Agentic-Senior-Core
 ```
 
-Preview changes with `--dry-run`, then apply with `--yes`. Upgrade prunes obsolete managed files by default; use `--no-prune` to keep them. User-owned files without Agentic markers are never overwritten.
+After install, every Claude Code session injects the rules on startup -- including subagents.
 
----
+</details>
 
-## Core Commands
+<details>
+<summary><b>Codex CLI</b> (terminal agent)</summary>
 
-> [!NOTE]
-> To run commands directly without `npx` (e.g., `ascx` or `agentic-senior-core`), install the CLI globally: `npm install -g @ryuenn3123/agentic-senior-core`.
+```bash
+codex plugins install agentic-senior-core
+```
 
-| Command | Purpose |
-|---------|---------|
-| `agentic-senior-core init` | Initialize the compact project guidance pack and native agent entrypoints |
-| `agentic-senior-core upgrade --dry-run` | Preview managed-surface upgrades |
-| `agentic-senior-core context "<request>" --json --file src/app/page.tsx` | Resolve request labels, rules, prompts, docs, file signals, budget status, and fallback status |
-| `ascx <command>` | Run a command through the local evidence-preserving output wrapper (safely falls back to passthrough if unsupported) |
-| `asc optimize status` | Check ASCX runtime token saver readiness |
-| `asc optimize doctor` | Diagnose ASCX availability, tee write safety, and compression conflicts |
-| `agentic-senior-core optimize --show` | Show token optimization state |
-| `agentic-senior-core mcp` | Start local MCP stdio runtime |
-| `npm run clean:local` | Remove ignored local reports, backups, benchmarks, and active-memory state |
+Rules load automatically via plugin hooks on every session.
 
-`ascx` dynamically compresses supported commands with noisy output (e.g., builds, tests, searches, and git logs). Other commands, pipes, redirects, and unsupported shell shapes safely pass through without compression. Compressed output includes a structured footer with command, exit code, filter name, estimated token reduction, and a raw tee path when safety requires it.
+</details>
 
-`asc` is a short alias for the main `agentic-senior-core` CLI. The doctor does not probe localhost services in this phase; `9router` status remains `not-checked`.
+<details>
+<summary><b>Gemini CLI</b> (terminal agent)</summary>
 
----
+Auto-detected. Gemini CLI reads `gemini-extension.json` from the installed package and loads `AGENTS.md` as context. Commands available as `.toml` format (`/asc-refactor`, `/asc-review`, `/asc-audit`).
 
-## What It Does
+</details>
 
-A coding agent that has read every framework tutorial still ships junior-grade work because nothing in its training tells it which trade-off matters in your codebase. This pack is a small set of plain-language rules an agent loads only when the work scope calls for them. The rules are written as invariants and bad habits to reject, not as opinions about which framework is fashionable. You install it with one command, revert with a backup, and it does not depend on any IDE or LLM provider.
+<details>
+<summary><b>Copilot CLI</b> (terminal agent)</summary>
 
-### How It Works
+Plugin files ship at `.github/plugin/`. After global npm install, register the plugin per your Copilot CLI version. Rules inject via hooks on every session.
 
-1. Agent reads `AGENTS.md` at the start of each session.
-2. `AGENTS.md` activates the default triad: Adaptive Context for scoped rule selection, ASCX wrappers for supported noisy commands, and Compact Natural Mode for final replies.
-3. For shell commands, the agent uses `ascx` wrappers that compress noisy output while preserving debugging evidence (exit codes, file paths, line numbers, root errors, truncation markers, and raw tee paths).
-4. For final replies, the agent applies `.agent-context/prompts/compact-natural-mode.md` so answers stay concise without losing commands, paths, errors, assumptions, validation status, risks, or next actions.
-5. Detailed rules live under `.agent-context/rules/` and load by scope: 21 rule files covering architecture, security, performance, testing, database, API, frontend, Docker, observability, resilience, migrations, background jobs, configuration, and versioning.
+</details>
 
-### Instruction Entrypoints
+<details>
+<summary><b>Cursor</b> (IDE)</summary>
 
-The canonical installed source is `AGENTS.md`.
+Run from your project root:
 
-Default init and upgrade keep the project root compact:
-- `AGENTS.md`
-- `CLAUDE.md`
-- `GEMINI.md`
-- `.agent-context/`
+```bash
+asc adapter --cursor
+```
 
-`CLAUDE.md` and `GEMINI.md` are native import bridges that load `AGENTS.md`. Detailed rules, prompts, checklists, policies, and state stay under `.agent-context/` and load by task scope.
+This copies one file to `.cursor/rules/agentic-senior-core.mdc`. Cursor reads it automatically on every session. Repeat per project.
 
-Deprecated legacy files (`.instructions.md`, `.agent-instructions.md`, `.cursorrules`, `.windsurfrules`, tool-specific rule directories) are no longer generated. Upgrade prunes Agentic-managed copies while preserving user-owned files.
+</details>
 
-### Long-Term Stability
+<details>
+<summary><b>Windsurf</b> (IDE)</summary>
 
-Rules are written as invariants, outcomes, and freshness criteria, not as named patterns, library prescriptions, or magic-number thresholds. Where a rule cites a specific tool or threshold, the citation block carries a freshness anchor so the next maintainer knows when the technology references were last validated.
+```bash
+asc adapter --windsurf
+```
 
----
+Copies one file to `.windsurf/rules/agentic-senior-core.md`. Repeat per project.
 
-## MCP Quick Setup (VS Code)
+</details>
 
-1. Generate workspace MCP config:
+<details>
+<summary><b>Cline</b> (VS Code extension)</summary>
 
 ```bash
-npx @ryuenn3123/agentic-senior-core init --mcp-template
+asc adapter --cline
 ```
 
-2. Open `MCP: Open Workspace Folder Configuration`.
-3. Confirm `.vscode/mcp.json` points to `node ./scripts/mcp-server.mjs` with `cwd: ${workspaceFolder}`.
-4. Trust and start the server in Chat Customizations > MCP Servers.
+Copies one file to `.clinerules/agentic-senior-core.md`. Repeat per project.
 
-Optional: enable `chat.mcp.autoStart` (Experimental) for auto-restart when MCP config changes.
+</details>
 
-If you see `Property $schema is not allowed`, keep `.vscode/mcp.json` without `$schema` and keep only `servers`.
+<details>
+<summary><b>GitHub Copilot</b> (VS Code extension)</summary>
 
----
+```bash
+asc adapter --copilot
+```
 
-## Design Direction
+Copies one file to `.github/copilot-instructions.md`. Repeat per project.
 
-For UI, UX, layout, screen, Tailwind, frontend, or redesign work, the pack routes agents through a compact design bootstrap before code changes. The flow asks the agent to reject generic defaults, choose a concrete interaction anchor, record creative commitments, and write the result into `docs/DESIGN.md`. Existing projects read the real repository and docs first; fresh projects ask the agent to recommend the stack from current evidence instead of hardcoding a framework.
+</details>
 
-See [docs/doc-index.md](docs/doc-index.md) for the full doc routing map.
+<details>
+<summary><b>Kiro</b> (IDE)</summary>
 
----
+```bash
+asc adapter --kiro
+```
 
-## What's New
+Copies one file to `.kiro/steering/agentic-senior-core.md`. Repeat per project.
 
-### v4.2
+</details>
 
-Adds `ascx` command wrapper to optimize token usage via high-signal adapters for `git status`, `git diff`, and `npm test` alongside the `Compact Natural Mode` response compression contract to reduce token overhead while retaining high-fidelity reasoning.
+<details>
+<summary><b>Google Antigravity</b> (IDE)</summary>
 
-### v4.1
+**Option A -- workspace rules (per project):**
 
-Adds six backend rule files (`OBS-*`, `RES-*`, `MIG-*`, `JOB-*`, `CFG-*`, `VER-*`) and targeted refinements to `frontend-architecture.md`, `security.md`, `database-design.md`, and `api-docs.md`. See [CHANGELOG.md](CHANGELOG.md) for the full list.
+Copy `.agents/rules/agentic-senior-core.md` into your project. Antigravity reads it automatically with `trigger: always_on`.
 
-### v4.0
+**Option B -- global plugin (all projects):**
 
-Numbered Markdown rules with stable section IDs, bounded reflection, provider-free anti-halu benchmark, three-layer prompt caching contract, and per-integration caching scope enforcement. Caching numbers are scoped per integration; IDE wrapper integrations receive prefix stability without a measurable per-pack saving. See [docs/benchmark-reference.md](docs/benchmark-reference.md) for the reporting format and [CHANGELOG.md](CHANGELOG.md) for details.
+```bash
+# Via Antigravity CLI
+agy plugin install https://github.com/fatidaprilian/Agentic-Senior-Core.git
+
+# Or manually copy the plugin bundle to:
+# ~/.gemini/config/plugins/agentic-senior-core/
+```
 
-Current package version: 4.3.3. Last published version: 4.3.2.
+The plugin bundle includes rules, skills (`/asc-review`, `/asc-audit`, `/asc-refactor`), and `plugin.json`.
 
----
+</details>
+
+<details>
+<summary><b>Devin / Hermes / OpenCode / OpenClaw</b></summary>
+
+Plugin manifests ship in the npm package at their standard paths (`.devin-plugin/`, `plugin.yaml`, `.opencode/plugins/`, `.openclaw/skills/`). After global npm install, each host auto-discovers or manually register per host docs.
+
+</details>
+
+<details>
+<summary><b>All IDE adapters at once</b></summary>
+
+```bash
+asc adapter --all
+```
 
-## Validation
+Generates adapter files for Cursor, Windsurf, Cline, Copilot, and Kiro in one go.
+
+</details>
+
+**Terminal agents** (Claude Code, Codex, Gemini, Copilot CLI) = install once, always-on, zero per-project files.
+**IDE agents** (Cursor, Windsurf, Cline, Copilot VS Code, Kiro, Antigravity) = one file per project via `asc adapter` or copy.
+
+### Updating
+
+Already installed? Just update the global package:
 
 ```bash
-npm run validate
-npm test
-npm run gate:release
-npm run benchmark:ascx
+npm update -g @ryuenn3123/agentic-senior-core
 ```
 
+Terminal agent plugins pick up the new version automatically on next session. For IDE adapters, re-run `asc adapter --all` in each project to refresh the adapter files.
+
+---
+
+## What It Does
+
+AI coding agents over-build by default. Ask for a date picker, the agent installs a library, writes a wrapper component, adds a stylesheet, and opens a timezone discussion.
+
+This plugin loads universal engineering rules on every session. Before writing any code, the agent runs a decision ladder:
+
+1. Does this need to be built at all?
+2. Does the codebase already have this?
+3. Does the stdlib or a native platform feature cover it?
+4. Does an already-installed dependency solve it?
+5. Can this be one straightforward function?
+6. Only then: write the minimum code that works.
+
+The rules also cover security, architecture, testing, error handling, API design, database safety, frontend accessibility, infrastructure, resilience, and async patterns. All universal invariants -- no project-specific configuration needed.
+
+### Not lazy about
+
+Input validation at trust boundaries, parameterized queries, auth checks, error handling that prevents data loss, accessibility, anything explicitly requested. These are never skipped.
+
 ---
 
-## Reference Docs
+## Supported Hosts
+
+| Host | Type | Install | Per-project files? |
+|------|------|---------|-------------------|
+| Claude Code | Terminal agent | `claude plugin add` | No |
+| Codex CLI | Terminal agent | `codex plugins install` | No |
+| Gemini CLI | Terminal agent | Auto-detected | No |
+| Copilot CLI | Terminal agent | Plugin registration | No |
+| Devin | Terminal agent | Auto-detected | No |
+| Hermes | Terminal agent | Plugin registration | No |
+| OpenCode | Terminal agent | Auto-detected | No |
+| OpenClaw | Terminal agent | Auto-detected | No |
+| Antigravity | IDE | `agy plugin install` or copy rules | No (plugin) / Yes (rules) |
+| Cursor | IDE | `asc adapter --cursor` | Yes (1 file) |
+| Windsurf | IDE | `asc adapter --windsurf` | Yes (1 file) |
+| Cline | VS Code ext | `asc adapter --cline` | Yes (1 file) |
+| GitHub Copilot | VS Code ext | `asc adapter --copilot` | Yes (1 file) |
+| Kiro | IDE | `asc adapter --kiro` | Yes (1 file) |
 
-- FAQ: docs/faq.md
-- Deep dive internals: docs/deep-dive.md
-- Deep analysis and roadmap: docs/deep-analysis-and-roadmap-backlog.md
-- Integration playbook: docs/integration-playbook.md
-- Benchmark and stack reference: docs/benchmark-reference.md
-- Project history: docs/archive/HISTORY.md
+---
+
+## Commands
+
+Available on plugin hosts (Claude Code, Codex, Gemini CLI):
+
+| Command | Purpose |
+|---------|---------|
+| `/asc-refactor` | Structured refactoring workflow |
+| `/asc-review` | Production-risk code review with severity-ordered findings |
+| `/asc-audit` | Security and architecture audit |
+| `/asc-help` | Show available commands |
 
 ---
 
-## Release and npm Publish Flow
+## CLI
 
-This repository publishes to npm through GitHub Actions on push to `main`.
+```bash
+asc adapter [--cursor|--windsurf|--cline|--copilot|--kiro|--all]
+asc clean [--dry-run]
+asc status
+asc mcp
+asc --version
+asc --help
+```
 
-Release checklist:
+`ascx` is a token-saving command wrapper that compresses noisy output while preserving debugging evidence. Install globally and use as: `ascx git status`, `ascx npm test`.
 
-1. Run `node scripts/bump-version.mjs <version>`.
-2. Fill the matching release notes in `CHANGELOG.md`.
-3. Run `npm run check:adapters`, `npm run validate`, `npm test`, `npm run gate:release`, and `git diff --check`.
-4. Commit with a Conventional Commit message.
-5. Push to `origin/main`.
+---
+
+## Works With Other Plugins
+
+ASC covers universal engineering standards (security, architecture, testing, API design, database safety). It is complementary to:
+
+- **ponytail** -- YAGNI minimalism and code reduction
+- **awesome-cursorrules** -- Framework-specific context and stack declarations
 
-Package scope: `@ryuenn3123`. GitHub owner: `fatidaprilian`.
+Use them together. No conflicts.
 
 ---
 
-## Terminology Mapping (Final)
+## Migration from v4.x
 
-| Canonical Term | Developer-Facing Alias | Usage Rule |
-|----------------|------------------------|------------|
-| Federated Governance | Federated Rules Operations | Use canonical term in formal policy artifacts. |
-| Governance Engine | Rules Engine | Use alias in onboarding and day-to-day developer docs. |
-| Guardrails | Quality Checks | Use alias in implementation guidance and quickstart docs. |
+v5.0 is a breaking change. The per-project system (`.agent-context/`, bridge files, project scaffolding) is replaced by the universal plugin system.
 
-Rule: on first mention in developer-facing docs, include canonical term in parentheses.
+Clean up v4 artifacts from any project:
+```bash
+# Preview what will be removed
+asc clean --dry-run
 
-Examples:
-- `Federated Rules Operations (Federated Governance)`
-- `Rules Engine (Governance Engine)`
-- `quality checks (guardrails)`
+# Remove v4 files (.agent-context/, AGENTS.md, CLAUDE.md, GEMINI.md, etc.)
+asc clean
+```
 
-Compliance boundary: formal policy and audit artifacts must keep canonical terminology for operational traceability.
+This removes `.agent-context/`, `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, and other v4 bridge files from the current project directory. The global plugin replaces all of them.
 
 ---
 
-## License
+## Token Budget
+
+| Component | Tokens | When loaded |
+|-----------|--------|------------|
+| Rules (`AGENTS.md`) | ~1,200 | Every session + every subagent |
+| Each skill | ~500-800 | On user invocation only |
+| Commands | 0 | Metadata only |
 
-MIT - Use freely, enforce strictly.
+Total always-on cost: ~1,200 tokens per session.

package/__init__.py

@@ -0,0 +1,61 @@
+"""Hermes plugin for Agentic Senior Core."""
+
+from __future__ import annotations
+
+import os
+from pathlib import Path
+from typing import Any
+
+ROOT = Path(__file__).resolve().parent
+SKILLS_DIR = ROOT / "skills"
+AGENTS_MD = ROOT / "AGENTS.md"
+
+SKILL_COMMANDS = {
+    "asc-refactor": "Structured refactoring workflow with pre-checks and validation.",
+    "asc-review": "Production-risk code review with severity-ordered findings.",
+    "asc-audit": "Security and architecture audit.",
+    "asc-help": "Show available ASC commands.",
+}
+
+
+def _read_agents_md() -> str:
+    try:
+        return AGENTS_MD.read_text(encoding="utf-8")
+    except OSError:
+        return ""
+
+
+def _pre_llm_call(**_: Any) -> dict[str, str] | None:
+    content = _read_agents_md()
+    return {"context": content} if content else None
+
+
+def _make_skill_handler(ctx: Any, command: str):
+    def handler(raw_args: str) -> str:
+        prompt = f"Load and follow the skill `asc:{command}`. {SKILL_COMMANDS[command]}"
+        if raw_args and raw_args.strip():
+            prompt += f"\n\nUser arguments: {raw_args.strip()}"
+        try:
+            if ctx.inject_message(prompt):
+                return f"Queued `{command}` for the agent."
+        except Exception:
+            pass
+        return prompt
+    return handler
+
+
+def register(ctx: Any) -> None:
+    for child in sorted(SKILLS_DIR.iterdir() if SKILLS_DIR.exists() else []):
+        skill_md = child / "SKILL.md"
+        if child.is_dir() and skill_md.exists():
+            ctx.register_skill(child.name, skill_md)
+
+    ctx.register_hook("pre_llm_call", _pre_llm_call)
+
+    for command, description in SKILL_COMMANDS.items():
+        ctx.register_command(
+            command,
+            _make_skill_handler(ctx, command),
+            description=description,
+            args_hint="[target or notes]",
+        )

package/bin/agentic-senior-core.js

@@ -1,33 +1,45 @@
 #!/usr/bin/env node
 /**
- * Agentic-Senior-Core CLI — Thin entry point.
+ * Agentic-Senior-Core CLI v5 -- Universal plugin system.
  *
- * All logic lives in lib/cli/ modules. This file only handles
- * argument dispatch and the top-level error boundary.
+ * Commands:
+ *   adapter   Generate instruction-tier adapter files for IDEs without plugin support
+ *   clean     Remove v4 per-project artifacts (.agent-context/, bridge files)
+ *   status    Show detected IDEs and install hints
+ *   mcp       Start MCP stdio server
  */
 import { exit } from 'node:process';
-
-import { CLI_VERSION } from '../lib/cli/constants.mjs';
-import { printUsage } from '../lib/cli/utils.mjs';
-import { runLaunchCommand } from '../lib/cli/commands/launch.mjs';
-import { runRollbackCommand } from '../lib/cli/commands/rollback.mjs';
-import { runMcpServerCommand } from '../lib/cli/commands/mcp.mjs';
-import { runOptimizeCommand, parseOptimizeArguments } from '../lib/cli/commands/optimize.mjs';
-import { runInitCommand, parseInitArguments } from '../lib/cli/commands/init.mjs';
-import { runUpgradeCommand, parseUpgradeArguments } from '../lib/cli/commands/upgrade.mjs';
-import { runContextCommand } from '../lib/cli/commands/context.mjs';
-
+import { readFileSync } from 'node:fs';
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const currentFilePath = fileURLToPath(import.meta.url);
+const repositoryRoot = resolve(dirname(currentFilePath), '..');
+const packageJson = JSON.parse(readFileSync(resolve(repositoryRoot, 'package.json'), 'utf8'));
+const CLI_VERSION = packageJson.version;
+
+function printUsage() {
+  console.log(`Agentic-Senior-Core CLI v${CLI_VERSION}`);
+  console.log('Universal AI coding rules. Write code like a staff engineer.\n');
+  console.log('Plugin install (always-on, no per-project files):');
+  console.log('  Claude Code:  /plugin marketplace add fatidaprilian/Agentic-Senior-Core');
+  console.log('  Codex CLI:    codex plugins install agentic-senior-core\n');
+  console.log('Adapter install (one file per project):');
+  console.log('  asc adapter --cursor --windsurf --cline --copilot --kiro --all\n');
+  console.log('Commands:');
+  console.log('  adapter       Generate instruction-tier adapter files');
+  console.log('  clean         Remove v4 per-project artifacts');
+  console.log('  status        Show detected IDEs and install hints');
+  console.log('  mcp           Start MCP stdio server');
+  console.log('  --version     Show version');
+  console.log('  --help        Show this help');
+}
 
 async function main() {
   const commandArgument = process.argv[2];
   const commandArguments = process.argv.slice(3);
 
-  if (!commandArgument || commandArgument === 'launch') {
-    await runLaunchCommand();
-    return;
-  }
-
-  if (commandArgument === '--help' || commandArgument === '-h') {
+  if (!commandArgument || commandArgument === '--help' || commandArgument === '-h') {
     printUsage();
     return;
   }
@@ -37,41 +49,30 @@ async function main() {
     return;
   }
 
-  if (commandArgument === 'upgrade') {
-    const upgradeOptions = parseUpgradeArguments(commandArguments);
-    await runUpgradeCommand(upgradeOptions.targetDirectory, upgradeOptions);
-    return;
-  }
-
-  if (commandArgument === 'optimize') {
-    const optimizeOptions = parseOptimizeArguments(commandArguments);
-    await runOptimizeCommand(optimizeOptions.targetDirectory, optimizeOptions);
+  if (commandArgument === 'adapter') {
+    const { runAdapterCommand } = await import('../lib/cli/commands/adapter.mjs');
+    await runAdapterCommand(commandArguments);
     return;
   }
 
-  if (commandArgument === 'context') {
-    await runContextCommand(commandArguments);
+  if (commandArgument === 'clean') {
+    const { runCleanCommand } = await import('../lib/cli/commands/clean.mjs');
+    await runCleanCommand(commandArguments);
     return;
   }
 
-  if (commandArgument === 'init') {
-    const initOptions = parseInitArguments(commandArguments);
-    await runInitCommand(initOptions.targetDirectory, initOptions);
-    return;
-  }
-
-  if (commandArgument === 'rollback') {
-    await runRollbackCommand(commandArguments);
+  if (commandArgument === 'status') {
+    const { runStatusCommand } = await import('../lib/cli/commands/status.mjs');
+    await runStatusCommand();
     return;
   }
 
   if (commandArgument === 'mcp') {
+    const { runMcpServerCommand } = await import('../lib/cli/commands/mcp.mjs');
     await runMcpServerCommand();
     return;
   }
 
-
-
   console.error(`Unknown command: ${commandArgument}`);
   printUsage();
   exit(1);

package/commands/asc-audit.md

@@ -0,0 +1 @@
+Run the security and architecture audit from skills/asc-audit/SKILL.md. Examine trust boundaries, auth, data handling, architecture boundaries, dependency health, and error exposure. Report findings with severity, evidence, and remediation.

package/commands/asc-audit.toml

@@ -0,0 +1,2 @@
+description = "Security and architecture audit"
+prompt = "Load and follow the asc-audit skill. Audit trust boundaries, auth/authz, data handling, architecture boundaries, dependency health, and error exposure. For every finding report severity (critical/high/medium/low), vulnerability class, location, impact, evidence, remediation, and validation steps. Findings ordered by severity."

package/commands/asc-help.md

@@ -0,0 +1,9 @@
+Show available Agentic Senior Core commands and skills.
+
+Available commands:
+- /asc-refactor -- Structured refactoring workflow
+- /asc-review -- Production-risk code review
+- /asc-audit -- Security and architecture audit
+- /asc-help -- This help
+
+The universal coding rules from AGENTS.md are always active. Skills provide deeper, on-demand workflows.

package/commands/asc-help.toml

@@ -0,0 +1,2 @@
+description = "Show available Agentic Senior Core commands"
+prompt = "Show the Agentic Senior Core command reference: /asc-refactor (structured refactoring workflow), /asc-review (production-risk code review with severity-ordered findings), /asc-audit (security and architecture audit), /asc-help (this help). ASC loads universal engineering rules covering code quality, architecture, security, error handling, testing, API design, database, frontend, infrastructure, resilience, and async patterns."

package/commands/asc-refactor.md

@@ -0,0 +1 @@
+Run the refactoring workflow from skills/asc-refactor/SKILL.md on the current code changes or specified files. Preserve existing behavior while improving structure, naming, boundaries, and maintainability.

package/commands/asc-refactor.toml

@@ -0,0 +1,2 @@
+description = "Structured refactoring workflow with pre-checks and validation"
+prompt = "Load and follow the asc-refactor skill. Read the target code, identify the smallest scope, apply refactor rules: improve clarity, boundaries, naming, validation, error handling, tests. Prioritize maintainability over compressed one-liners. No premature abstractions. Run a final simplification pass. For every change explain what risk existed, what changed, and why the new shape is safer."

package/commands/asc-review.md

@@ -0,0 +1 @@
+Run the code review workflow from skills/asc-review/SKILL.md on the current diff or specified files. Prioritize findings by severity: correctness and security first, then contracts, tests, architecture, and performance.

package/commands/asc-review.toml

@@ -0,0 +1,2 @@
+description = "Production-risk code review with severity-ordered findings"
+prompt = "Load and follow the asc-review skill. Review changed files for production risks. Priority order: correctness/data-loss/security, public contract drift, missing tests, architecture boundary drift, performance/accessibility with concrete impact. For every finding include file/line reference, real risk, and smallest safe fix. Report findings ordered by severity."

package/gemini-extension.json

@@ -0,0 +1,10 @@
+{
+  "name": "agentic-senior-core",
+  "version": "5.2.0",
+  "description": "Universal AI coding rules. Write code like a staff engineer.",
+  "author": "fatidaprilian",
+  "license": "MIT",
+  "contextFileName": "AGENTS.md",
+  "commands": ["commands/"],
+  "skills": ["skills/"]
+}

package/hooks/copilot-hooks.json

@@ -0,0 +1,21 @@
+{
+  "version": 1,
+  "hooks": {
+    "sessionStart": [
+      {
+        "type": "command",
+        "bash": "node \"${PLUGIN_ROOT}/hooks/session-start.js\"",
+        "powershell": "node \"${PLUGIN_ROOT}\\hooks\\session-start.js\"",
+        "timeoutSec": 5
+      }
+    ],
+    "subagentStart": [
+      {
+        "type": "command",
+        "bash": "node \"${PLUGIN_ROOT}/hooks/subagent-start.js\"",
+        "powershell": "node \"${PLUGIN_ROOT}\\hooks\\subagent-start.js\"",
+        "timeoutSec": 5
+      }
+    ]
+  }
+}