@alexandrealvaro/agentic 0.9.1-beta.1 → 0.9.3-beta.1

package/README.md

@@ -2,6 +2,8 @@
 
 A starter kit for engineering production code with LLMs. Lean templates and init prompts grounded in established standards: [Anthropic Skills](https://code.claude.com/docs/en/skills), [Claude Code subagents](https://code.claude.com/docs/en/sub-agents), [agents.md](https://agents.md), Nygard ADRs, [GitHub Spec Kit](https://github.com/github/spec-kit), and [Google Labs DESIGN.md](https://github.com/google-labs-code/design.md).
 
+**The framing.** An LLM is the super-soldier serum; the engineer is Steve Rogers. The serum amplifies what the engineer already brings — solid bases, investigation, care for quality, architecture, clean code, observability, maintainability. The kit encodes those bases as skills, ADRs, and gates so the amplification compounds in the right direction. See [WORKFLOW.md](WORKFLOW.md) for the principles.
+
 The CLI installs nine universal skills (`agentic-bootstrap`, `agentic-philosophy`, `agentic-architecture`, `agentic-adr`, `agentic-spec`, `agentic-task`, `agentic-audit`, `agentic-review`, `agentic-ground`) plus three conditional ones (`agentic-design` for frontend, `agentic-subagent` for Claude Code, `agentic-skill` opt-in) into the agent's native location. Each skill produces its artifact or runs its operation via the agent's native conversational UI; `agentic update` keeps installed skills in sync with upstream kit changes via a state-aware three-way diff. Report rough edges via [GitHub Issues](https://github.com/alexandremendoncaalvaro/agentic-development/issues); current releases live under [GitHub Releases](https://github.com/alexandremendoncaalvaro/agentic-development/releases).
 
 ## Prerequisites

package/WORKFLOW.md

@@ -2,6 +2,8 @@
 
 Engineering production code with LLMs. Agentic, not vibe coding.
 
+**The Steve Rogers framing.** The LLM is the super-soldier serum. The engineer is Steve Rogers. The serum amplifies what the engineer already brings — solid bases, organization, investigation, care for quality, architecture, clean code, documentation, observability, maintainability. Add the serum to a disciplined engineer and you get Captain America. Add it to an undisciplined one and you get faster sloppy at scale. This document is those bases written down as principles. The discipline is the input; the LLM is the amplifier; the kit (skills, ADRs, audits, gates) is the scaffolding that keeps the discipline intact across sessions, agents, and projects.
+
 **The principle behind the rest:** context engineering beats prompt engineering. Context is finite and decays as it fills — aim for the smallest set of high-signal tokens that gets the outcome.
 
 ## TL;DR
@@ -25,7 +27,7 @@ What to keep in mind:
 13. **Automation needs rails.** Hooks, tests, lint, CI, sandboxing, and permissions matter more than advisory text the agent can forget.
 14. **Autonomy requires observability.** If the agent makes decisions, log the trajectory: tool calls, intermediate outputs, failures.
 15. **Staged spikes when the technique is uncertain.** When the *how* is unknown — a library choice, a CV technique, a multi-stage transformation — break the problem into staged spikes against golden fixtures with per-stage debug artifacts.
-16. **Discipline scales with project maturity.** Same principles bind every project; the artifact set scales. A spike runs posture + research + audit; a regulated product adds spec / ADR / hooks / evals. The toolkit amplifies what the project needs — never imposes ceremony beyond it. Configurable at init; changeable as the project matures.
+16. **Discipline scales with project maturity.** Same principles bind every project; the artifact set scales. A spike runs posture + research + audit; a regulated product adds spec / ADR / hooks / evals. Add ceremony only where it changes agent behavior; configure at init and reconfigure as the project matures.
 
 > Working with agents means trading typing for technical direction. The value is in giving the right context, setting boundaries, validating the result, and keeping "almost right" out of production.
 
@@ -168,6 +170,8 @@ Two 2025 industry surveys point at the same wall. JetBrains' DevEcosystem 2025 r
 
 The takeaway: §10 (Reviewer) and §11 (Quality Gates) are not optional. Skipping them is where bug density grows.
 
+Per the Steve Rogers framing in the preamble: the serum cannot manufacture discrimination — it amplifies whatever discrimination the engineer already brings. The kit's job is to encode discrimination into the agent's context (specs, ADRs, fresh-context reviews, deterministic gates) so the amplification compounds in the disciplined direction even when the engineer is sleepy, rushed, or handing off to another collaborator.
+
 ## 13. Evals for Anything Autonomous
 
 If your agent is making decisions on its own, you need evals. A few principles:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alexandrealvaro/agentic",
-  "version": "0.9.1-beta.1",
+  "version": "0.9.3-beta.1",
   "description": "Bootstrap and audit AGENTS.md, ARCHITECTURE.md, ADRs, skills, and subagents for engineering production code with LLMs",
   "type": "module",
   "bin": {

package/src/lib/install.js

@@ -10,7 +10,7 @@ import {
   unlinkSync,
 } from 'node:fs';
 import { fileURLToPath } from 'node:url';
-import { basename, dirname, join, relative } from 'node:path';
+import { basename, dirname, join, relative, sep as PATH_SEP } from 'node:path';
 import { SCHEMA_VERSION } from './state.js';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
@@ -18,6 +18,17 @@ const KIT_ROOT = join(__dirname, '..', '..');
 
 const MANIFEST_FILE = 'manifest.json';
 
+/**
+ * Normalize a filesystem path to forward-slash form so internal
+ * comparisons (manifest subagent declarations, state-file paths, action
+ * report paths) are platform-independent. Manifests and state files are
+ * authored with `/`; on Windows, native `path.join` and `path.relative`
+ * produce `\\`, which breaks Set/Map lookups against the canonical form.
+ */
+function toPosix(p) {
+  return PATH_SEP === '/' ? p : p.split(PATH_SEP).join('/');
+}
+
 const AGENT_LAYOUT = {
   'claude-code': {
     skillsDir: '.claude/skills',
@@ -45,7 +56,10 @@ function walkSkill(srcRoot) {
       if (statSync(abs).isDirectory()) {
         walk(abs, rel);
       } else {
-        out.push({ src: abs, rel });
+        // `rel` is the manifest-comparable path; force posix form so
+        // Windows backslashes do not break Set/Map lookups against
+        // forward-slash declarations in manifest.json.
+        out.push({ src: abs, rel: toPosix(rel) });
       }
     }
   }
@@ -200,7 +214,10 @@ export async function installSkills({
 
         const target = targetForRel(rel, layout, targetRoot, cwd, subagentSet);
         if (!target) continue;
-        const relForReport = relative(cwd, target);
+        // Force posix form so the path is identical across platforms in
+        // the action log and in the per-agent state file. Windows users
+        // sharing a state file with macOS / Linux teammates depend on it.
+        const relForReport = toPosix(relative(cwd, target));
         const prevSha = prevByPath.has(relForReport)
           ? prevByPath.get(relForReport)
           : null;