@ryuenn3123/agentic-senior-core 1.8.0 → 1.8.1

package/README.md

@@ -45,6 +45,16 @@ The **Use this template** button is in the GitHub repository header (top-right a
 If you prefer a direct link, open: **[Create from template](https://github.com/fatidaprilian/Agentic-Senior-Core/generate)**.
 Your new repository will instantly possess all the rules, configurations, and AI context files directly out of the box — zero CLI needed.
 
+### Option 0: NPM Install (Local or Global)
+
+If you already know you want the CLI from npm, use one of these paths:
+
+```bash
+npm exec --yes @fatidaprilian/agentic-senior-core init
+npm install -g @fatidaprilian/agentic-senior-core
+agentic-senior-core init
+```
+
 ### Option 1: Interactive via GitHub Source (Pre-publish friendly)
 
 If npm package publication is not ready yet, run the CLI directly from GitHub and still keep the full interactive experience.
@@ -55,6 +65,14 @@ npm exec --yes --package=github:fatidaprilian/Agentic-Senior-Core agentic-senior
 
 This gives the same interactive prompts to choose your profile (`beginner`, `balanced`, `strict`), stack, blueprint, and CI guardrails.
 
+If you want a plug-and-play starter instead of answering every question, use a preset:
+
+```bash
+npx @fatidaprilian/agentic-senior-core init --preset frontend-web
+npx @fatidaprilian/agentic-senior-core init --preset backend-api
+npx @fatidaprilian/agentic-senior-core init --preset mobile-react-native
+```
+
 ### Option 2: GitHub Bootstrap Scripts (No npx required)
 
 Run directly from this repository bootstrap script and inject rules into your project root.
@@ -85,7 +103,7 @@ If you have an existing project and want to infuse it with Staff-level context:
 npx @fatidaprilian/agentic-senior-core init
 ```
 
-Use team defaults (V1.6 track) with profile packs:
+Use team defaults (V1.8 track) with profile packs:
 
 ```bash
 npx @fatidaprilian/agentic-senior-core init --profile-pack startup
@@ -98,10 +116,63 @@ If you are totally new to concepts like blueprints and guardrails, no problem
 npx @fatidaprilian/agentic-senior-core init --newbie
 ```
 
+### Skill Selector
+
+Use the unified skill selector to pick the right pack for a domain:
+
+```bash
+agentic-senior-core skill frontend --tier advance
+agentic-senior-core skill backend --tier expert
+agentic-senior-core skill fullstack --json
+```
+
+When you run `init`, the CLI now auto-activates the matching skill packs for the chosen stack and blueprint, so the compiled governance context includes the relevant frontend, backend, fullstack, and CLI guidance by default.
+
+### Install and Setup Choices
+
+The CLI now supports a smaller decision surface for first-time setup:
+
+| Path | Best for |
+|------|----------|
+| `agentic-senior-core launch` | Numbered interactive chooser for install and preset paths |
+| GitHub Template | Zero-install project bootstrap |
+| npm exec / npx | One-off setup on an existing repo |
+| npm install -g | Repeated local use from the shell |
+| `--preset` | Fast bootstrap with a curated stack and blueprint |
+
+### Supported Stack Map
+
+Use the stack that matches the project you are actually starting:
+
+| Stack | Recommended Blueprint | Best Fit |
+|-------|-----------------------|----------|
+| TypeScript | api-nextjs | Web app, fullstack product, CLI tooling |
+| Python | fastapi-service | API service, automation, data-heavy backend |
+| Go | go-service | Small, fast services and platform tooling |
+| Java | spring-boot-api | Enterprise APIs and service-oriented systems |
+| PHP | laravel-api | Conventional product backends |
+| C# | aspnet-api | Microsoft stack services and enterprise apps |
+| Rust | go-service | Performance-sensitive backend work |
+| Ruby | laravel-api | Mature product services and backend workflows |
+| React Native | mobile-app | Cross-platform mobile applications |
+| Flutter | mobile-app | Cross-platform mobile applications |
+
+### Benchmark Comparison (Current State)
+
+| Capability | antigravity-awesome-skills | awesome-copilot | MiniMax-AI/skills | Agentic-Senior-Core |
+|------------|----------------------------|-----------------|-------------------|---------------------|
+| Skill organization | Large curated library | Resource catalog + governance docs | Domain-focused packs | Unified folder-based domain packs with tier routing |
+| Architecture guidance | Strong practical patterns | Strong SoC and layered architecture | Strong applied templates | Consolidated architecture + domain enforcement |
+| CLI governance | Limited | Moderate | Moderate | Init/upgrade/output governance with dry-run and structured reports |
+| Distribution operations | Basic | Moderate | Strong release checklists | Publish, rollback, compatibility gates plus benchmark/sbom flows |
+| Review quality | Pattern-oriented | Checklist-oriented | Gate-oriented | Planning/security/benchmark review model with CI integration |
+
 ### Option 4: Clone and Play
 Want to poke around under the hood? Just clone the repo and `npx @fatidaprilian/agentic-senior-core init` locally. No runtime dependencies needed — everything uses native Node.js!
 
-### Upgrade Existing Governance Packs (V1.6)
+### Upgrade Existing Governance Packs (V1.8)
+
+Yes, the upgrade flow still works. Use `--dry-run` first to preview changes, then apply with `--yes` when you are ready.
 
 Preview migration changes safely:
 
@@ -122,6 +193,9 @@ npx @fatidaprilian/agentic-senior-core upgrade --yes
 Our documentation has shifted into dedicated tracks to keep this README light:
 - **[FAQ / Concepts](docs/faq.md)**: Unfamiliar with Stacks, Blueprints, or Guardrails? Stalled on basic logic? Start here.
 - **[Deep Dive / Internals](docs/deep-dive.md)**: Explore the dynamic compiler, severity profiles, MCP integration, and granular LLM overrides here.
+- **[V2 Upgrade Playbook](docs/v2-upgrade-playbook.md)**: Benchmark-driven upgrade execution from antigravity-awesome-skills, awesome-copilot, and MiniMax skills.
+- **[Skill Platform](.agent-context/skills/README.md)**: Unified skill packs for frontend, backend, fullstack, CLI, distribution, and review quality with `advance` as the default tier.
+      The skill platform is now folder-based, so each domain has its own README and topic docs like a curated skills library.
 
 ---
 
@@ -215,6 +289,11 @@ npm run benchmark:detection
 - CycloneDX SBOM generation and compliance artifact workflow shipped.
 - Operations playbook and release-operations checklist shipped.
 
+### Current Forward Plan
+- V2.0: Skill marketplace trust tiers, transactional installs, rollback safety, and launch-menu onboarding.
+- V2.5: Cross-model benchmark harness and anti-regression quality gates.
+- V3.0: Enterprise governance cloud, policy drift detection, and org-level override registry.
+
 Detailed timeline and success metrics: [docs/roadmap.md](docs/roadmap.md)
 
 ---