@kleber.mottajr/juninho 1.0.1 → 1.2.0

package/dist/templates/commands.js

@@ -22,6 +22,7 @@ function writeCommands(projectDir) {
     (0, fs_1.writeFileSync)(path_1.default.join(commandsDir, "j.pr-review.md"), PR_REVIEW);
     (0, fs_1.writeFileSync)(path_1.default.join(commandsDir, "j.status.md"), STATUS);
     (0, fs_1.writeFileSync)(path_1.default.join(commandsDir, "j.unify.md"), UNIFY_CMD);
+    (0, fs_1.writeFileSync)(path_1.default.join(commandsDir, "j.finish-setup.md"), FINISH_SETUP);
 }
 // ─── /plan ────────────────────────────────────────────────────────────────────
 const PLAN = `# /plan — Strategic Planning
@@ -115,7 +116,7 @@ When ANY sub-agent returns output:
 Run \`/j.plan\` to create an execution plan, then \`/j.implement\` to build.
 `;
 // ─── /implement ───────────────────────────────────────────────────────────────
-const IMPLEMENT = `# /implement — Execute Plan or Spec
+const IMPLEMENT = `# /implement — Execute Plan or Spec
 
 Invoke the \`@j.implementer\` agent to build what was planned or specified.
 
@@ -134,22 +135,22 @@ Invoke the \`@j.implementer\` agent to build what was planned or specified.
 /j.implement docs/specs/user-profile.md
 \`\`\`
 
-## What happens
-
-1. \`@j.implementer\` reads the active \`plan.md\` (auto-loaded by plan-autoload plugin)
-2. Reads \`.opencode/state/workflow-config.md\` to understand handoff and UNIFY behavior
-3. Or reads the specified spec file
-4. Executes in waves:
-   - Wave 1: Foundation (schema, types, migrations)
-   - Wave 2: Core logic (services, API routes)
-   - Wave 3: Integration (wire-up, tests)
-5. Uses the fast pre-commit path while implementing:
-   - \`.opencode/scripts/lint-structure.sh\`
-   - \`.opencode/scripts/test-related.sh\`
-6. Spawns \`@j.validator\` for spec compliance
-7. Exits when code changes and task-level tests are complete
-8. The caller then runs \`.opencode/scripts/check-all.sh\` or \`/j.check\`
-9. If the repo-wide check fails, delegate back to \`@j.implementer\` with the failing output
+## What happens
+
+1. \`@j.implementer\` reads the active \`plan.md\` (auto-loaded by plan-autoload plugin)
+2. Reads \`.opencode/state/workflow-config.md\` to understand handoff and UNIFY behavior
+3. Or reads the specified spec file
+4. Executes in waves:
+   - Wave 1: Foundation (schema, types, migrations)
+   - Wave 2: Core logic (services, API routes)
+   - Wave 3: Integration (wire-up, tests)
+5. Uses the fast pre-commit path while implementing:
+   - \`.opencode/scripts/lint-structure.sh\`
+   - \`.opencode/scripts/test-related.sh\`
+6. Spawns \`@j.validator\` for spec compliance
+7. Exits when code changes and task-level tests are complete
+8. The caller then runs \`.opencode/scripts/check-all.sh\` or \`/j.check\`
+9. If the repo-wide check fails, delegate back to \`@j.implementer\` with the failing output
 
 ## Delegation Rule (MANDATORY)
 
@@ -162,58 +163,58 @@ When ANY sub-agent returns output:
 - Sub-agent unknowns/ambiguities are VALUABLE DATA — forward them to the user via \`question\` tool
 - If the sub-agent's report has gaps, pass those gaps to the user as questions — do NOT fill them yourself
 
-## After implementation
-
-Run \`/j.check\` for repo-wide verification.
-If \`/j.check\` fails, invoke \`/j.implement\` again with the failing output.
-Run \`/j.unify\` only after the full check passes and \`workflow-config.md\` enables UNIFY.
+## After implementation
+
+Run \`/j.check\` for repo-wide verification.
+If \`/j.check\` fails, invoke \`/j.implement\` again with the failing output.
+Run \`/j.unify\` only after the full check passes and \`workflow-config.md\` enables UNIFY.
 `;
 // ─── /sync-docs ───────────────────────────────────────────────────────────────
-const SYNC_DOCS = `# /sync-docs — Refresh AGENTS and Documentation
-
-Generate or update \`AGENTS.md\`, domain docs, and principle docs using the current code as source of truth.
-
-## Usage
-
-\`\`\`
-/j.sync-docs
-/j.sync-docs <path or domain>
-\`\`\`
-
-## What happens
-
-1. Read \`.opencode/state/workflow-config.md\`
-2. Identify key files for the requested scope
-3. Update the right doc surface for each kind of knowledge:
-   - \`AGENTS.md\` for directory-local working rules and commands
-   - \`docs/domain/*\` for business behavior and invariants
-   - \`docs/principles/*\` for cross-cutting technical patterns
-4. Add or refresh sync markers such as:
-   - \`<!-- juninho:sync source=src/payments/service.ts hash=abc123 -->\`
-5. Update \`docs/domain/INDEX.md\` and \`docs/principles/manifest\` when new docs are added or renamed
-
-## Rules
-
-- Prefer small, high-signal \`AGENTS.md\` files close to the code they describe
-- Keep business behavior out of \`AGENTS.md\`; put it in \`docs/domain/*\`
-- Keep technical principles reusable; do not bury them in a module-specific doc
-- Use key-file sync markers so doc drift is visible during later updates
-
-## Delegation Rule (MANDATORY)
-
-You MUST delegate this task to \`@j.implementer\` using the \`task()\` tool.
-Do NOT rewrite the docs yourself when the harness workflow asks for agent execution.
-
-## When to use
-
-- After finishing a feature before human review
-- After major refactors that changed local rules or business behavior
-- When CARL recall quality degrades because docs or manifests are stale
+const SYNC_DOCS = `# /sync-docs — Refresh AGENTS and Documentation
+
+Generate or update \`AGENTS.md\`, domain docs, and principle docs using the current code as source of truth.
+
+## Usage
+
+\`\`\`
+/j.sync-docs
+/j.sync-docs <path or domain>
+\`\`\`
+
+## What happens
+
+1. Read \`.opencode/state/workflow-config.md\`
+2. Identify key files for the requested scope
+3. Update the right doc surface for each kind of knowledge:
+   - \`AGENTS.md\` for directory-local working rules and commands
+   - \`docs/domain/*\` for business behavior and invariants
+   - \`docs/principles/*\` for cross-cutting technical patterns
+4. Add or refresh sync markers such as:
+   - \`<!-- juninho:sync source=src/payments/service.ts hash=abc123 -->\`
+5. Update \`docs/domain/INDEX.md\` and \`docs/principles/manifest\` when new docs are added or renamed
+
+## Rules
+
+- Prefer small, high-signal \`AGENTS.md\` files close to the code they describe
+- Keep business behavior out of \`AGENTS.md\`; put it in \`docs/domain/*\`
+- Keep technical principles reusable; do not bury them in a module-specific doc
+- Use key-file sync markers so doc drift is visible during later updates
+
+## Delegation Rule (MANDATORY)
+
+You MUST delegate this task to \`@j.implementer\` using the \`task()\` tool.
+Do NOT rewrite the docs yourself when the harness workflow asks for agent execution.
+
+## When to use
+
+- After finishing a feature before human review
+- After major refactors that changed local rules or business behavior
+- When CARL recall quality degrades because docs or manifests are stale
 `;
 // ─── /init-deep ───────────────────────────────────────────────────────────────
 const INIT_DEEP = `# /init-deep — Deep Codebase Initialization
 
-Perform a deep scan of the codebase and generate hierarchical AGENTS.md files, domain documentation, and local quality-gate scripts.
+Perform a deep scan of the codebase and generate hierarchical AGENTS.md files, domain documentation, and local quality-gate scripts.
 
 ## Usage
 
@@ -241,19 +242,19 @@ Writes to \`docs/domain/INDEX.md\`:
 - API route inventory
 - Service layer patterns
 
-### 3. Update principles manifest
-
-Adds entries to \`docs/principles/manifest\` (KEY=VALUE format):
-- Canonical code patterns discovered
-- Architectural directives
-- Technology decisions
-
-### 4. Refresh local automation stubs
-
-- Validate \`.opencode/scripts/lint-structure.sh\`
-- Validate \`.opencode/scripts/test-related.sh\`
-- Validate \`.opencode/scripts/check-all.sh\`
-- Align commands in \`AGENTS.md\` with the actual repository scripts
+### 3. Update principles manifest
+
+Adds entries to \`docs/principles/manifest\` (KEY=VALUE format):
+- Canonical code patterns discovered
+- Architectural directives
+- Technology decisions
+
+### 4. Refresh local automation stubs
+
+- Validate \`.opencode/scripts/lint-structure.sh\`
+- Validate \`.opencode/scripts/test-related.sh\`
+- Validate \`.opencode/scripts/check-all.sh\`
+- Align commands in \`AGENTS.md\` with the actual repository scripts
 
 ## When to use
 
@@ -376,9 +377,9 @@ Activate maximum parallelism mode — work until all tasks in execution-state.md
    - Each worktree works on independent files
    - No merge conflicts by design
 4. \`@j.validator\` runs after each wave
-5. Loop continues until all tasks are marked complete
-6. Run \`/j.check\` once task-level work is done
-7. \`@j.unify\` runs only if closeout is enabled in \`workflow-config.md\`
+5. Loop continues until all tasks are marked complete
+6. Run \`/j.check\` once task-level work is done
+7. \`@j.unify\` runs only if closeout is enabled in \`workflow-config.md\`
 
 ## When to use
 
@@ -405,13 +406,13 @@ Wave 3 (parallel):
 ## Safety
 
 - Each worktree is isolated — no cross-contamination
-- Merge happens only after all waves pass validation and the repo-wide check passes
+- Merge happens only after all waves pass validation and the repo-wide check passes
 - If any wave fails, the loop pauses and reports blockers
 `;
 // ─── /check ───────────────────────────────────────────────────────────────────
-const CHECK = `# /check — Run All Quality Gates
-
-Run the full repository verification after \`@j.implementer\` exits.
+const CHECK = `# /check — Run All Quality Gates
+
+Run the full repository verification after \`@j.implementer\` exits.
 
 ## Usage
 
@@ -419,31 +420,31 @@ Run the full repository verification after \`@j.implementer\` exits.
 /j.check
 \`\`\`
 
-## What runs
-
-\`.opencode/scripts/check-all.sh\`
-
-This script is expected to run the repository-wide checks for the current stack.
-Typical examples:
-- \`npm run typecheck && npm run lint && npm test\`
-- \`./gradlew test\`
-- \`./mvnw test\`
+## What runs
+
+\`.opencode/scripts/check-all.sh\`
+
+This script is expected to run the repository-wide checks for the current stack.
+Typical examples:
+- \`npm run typecheck && npm run lint && npm test\`
+- \`./gradlew test\`
+- \`./mvnw test\`
 
 ## When to use
 
-- After \`/j.implement\` returns control to the caller
-- Before \`/j.unify\`
-- After a refactor that touched many files or workflows
+- After \`/j.implement\` returns control to the caller
+- Before \`/j.unify\`
+- After a refactor that touched many files or workflows
 
 ## Notes
 
-This is intentionally broader than the pre-commit hook.
-The pre-commit hook stays fast and only runs structure lint plus tests related to staged files.
+This is intentionally broader than the pre-commit hook.
+The pre-commit hook stays fast and only runs structure lint plus tests related to staged files.
 `;
 // ─── /lint ────────────────────────────────────────────────────────────────────
-const LINT = `# /lint — Run Linter
-
-Run the structure lint used by the pre-commit path.
+const LINT = `# /lint — Run Linter
+
+Run the structure lint used by the pre-commit path.
 
 ## Usage
 
@@ -451,20 +452,20 @@ Run the structure lint used by the pre-commit path.
 /j.lint
 \`\`\`
 
-## What runs
-
-\`.opencode/scripts/lint-structure.sh\`
+## What runs
+
+\`.opencode/scripts/lint-structure.sh\`
 
 ## When to use
 
-- During active implementation, to catch structural issues quickly
-- When the pre-commit hook fails on lint and you want the same check on demand
-- After editing docs, scripts, or config files that need non-test validation
+- During active implementation, to catch structural issues quickly
+- When the pre-commit hook fails on lint and you want the same check on demand
+- After editing docs, scripts, or config files that need non-test validation
 `;
 // ─── /test ────────────────────────────────────────────────────────────────────
-const TEST = `# /test — Run Test Suite
-
-Run fast, change-scoped tests during implementation.
+const TEST = `# /test — Run Test Suite
+
+Run fast, change-scoped tests during implementation.
 
 ## Usage
 
@@ -481,18 +482,18 @@ Run fast, change-scoped tests during implementation.
 /j.test --watch
 \`\`\`
 
-## What runs
-
-\`.opencode/scripts/test-related.sh\`
-
-If the repository defines \`test:related\`, that script is preferred.
-Otherwise the default fallback tries tools such as \`jest --findRelatedTests\` or \`vitest related\`.
+## What runs
+
+\`.opencode/scripts/test-related.sh\`
+
+If the repository defines \`test:related\`, that script is preferred.
+Otherwise the default fallback tries tools such as \`jest --findRelatedTests\` or \`vitest related\`.
 
 ## When to use
 
-- During implementation, before leaving \`@j.implementer\`
-- When the pre-commit hook fails on related tests and you want to rerun the same scope
-- Use \`/j.check\` for the full repository suite after implementation
+- During implementation, before leaving \`@j.implementer\`
+- When the pre-commit hook fails on related tests and you want to rerun the same scope
+- Use \`/j.check\` for the full repository suite after implementation
 `;
 // ─── /pr-review ───────────────────────────────────────────────────────────────
 const PR_REVIEW = `# /pr-review — Advisory PR Review
@@ -518,22 +519,22 @@ Launch the \`@j.reviewer\` agent to perform an advisory code review on the curre
 - When you want a second opinion on the implementation quality
 - For pre-merge quality assurance
 
-## Distinction from @j.validator
-
-| \`@j.reviewer\` | \`@j.validator\` |
-|---|---|
-| Post-PR, advisory | During implementation loop |
-| "Is this good code?" | "Does this satisfy the spec?" |
-| Never blocks | Gates the pipeline |
-| Read-only | Can fix issues directly |
-
-## Quality target
-
-Aim for PR artifacts with the same quality bar as a strong human-authored engineering PR:
-- state the purpose and problem clearly
-- summarize the solution in reviewer-friendly steps
-- map changed files to responsibilities
-- provide runnable validation steps with expected outcomes
+## Distinction from @j.validator
+
+| \`@j.reviewer\` | \`@j.validator\` |
+|---|---|
+| Post-PR, advisory | During implementation loop |
+| "Is this good code?" | "Does this satisfy the spec?" |
+| Never blocks | Gates the pipeline |
+| Read-only | Can fix issues directly |
+
+## Quality target
+
+Aim for PR artifacts with the same quality bar as a strong human-authored engineering PR:
+- state the purpose and problem clearly
+- summarize the solution in reviewer-friendly steps
+- map changed files to responsibilities
+- provide runnable validation steps with expected outcomes
 `;
 // ─── /status ──────────────────────────────────────────────────────────────────
 const STATUS = `# /status — Show Current Work Status
@@ -566,9 +567,9 @@ Reads \`.opencode/state/execution-state.md\` directly.
 No agent needed — this is a direct state file read.
 `;
 // ─── /unify ───────────────────────────────────────────────────────────────────
-const UNIFY_CMD = `# /unify — Close the Loop
-
-Invoke the \`@j.unify\` agent to reconcile plan vs delivery and execute only the enabled closeout steps.
+const UNIFY_CMD = `# /unify — Close the Loop
+
+Invoke the \`@j.unify\` agent to reconcile plan vs delivery and execute only the enabled closeout steps.
 
 ## Usage
 
@@ -576,20 +577,20 @@ Invoke the \`@j.unify\` agent to reconcile plan vs delivery and execute only the
 /j.unify
 \`\`\`
 
-## What happens
-
-1. Read \`.opencode/state/workflow-config.md\`
-2. Reconcile \`plan.md\` vs actual git diff — mark tasks DONE/PARTIAL/SKIPPED
-3. Run only the enabled closeout steps, such as:
-   - update \`persistent-context.md\`
-   - refresh \`docs/domain/\` or \`docs/domain/INDEX.md\`
-   - merge worktrees
-   - create a PR
-4. If PR creation is enabled, draft a rich PR body with purpose, problem, solution, changed files, and validation steps
+## What happens
+
+1. Read \`.opencode/state/workflow-config.md\`
+2. Reconcile \`plan.md\` vs actual git diff — mark tasks DONE/PARTIAL/SKIPPED
+3. Run only the enabled closeout steps, such as:
+   - update \`persistent-context.md\`
+   - refresh \`docs/domain/\` or \`docs/domain/INDEX.md\`
+   - merge worktrees
+   - create a PR
+4. If PR creation is enabled, draft a rich PR body with purpose, problem, solution, changed files, and validation steps
 
 ## When to use
 
-After \`@j.implementer\` exits, \`/j.check\` passes, and \`@j.validator\` has approved the required work.
+After \`@j.implementer\` exits, \`/j.check\` passes, and \`@j.validator\` has approved the required work.
 
 ## Prerequisites
 
@@ -599,7 +600,81 @@ After \`@j.implementer\` exits, \`/j.check\` passes, and \`@j.validator\` has ap
 
 ## Note
 
-UNIFY behavior is controlled by \`.opencode/state/workflow-config.md\`.
-If PR creation or doc updates are disabled there, \`@j.unify\` should skip those steps and report what was intentionally not executed.
+UNIFY behavior is controlled by \`.opencode/state/workflow-config.md\`.
+If PR creation or doc updates are disabled there, \`@j.unify\` should skip those steps and report what was intentionally not executed.
+`;
+// ─── /finish-setup ───────────────────────────────────────────────────────────
+const FINISH_SETUP = `# /finish-setup — Generate Dynamic Skills and Documentation
+
+Scan the entire codebase, discover recurring file patterns, generate dynamic skills, and populate domain/principles documentation.
+
+## Usage
+
+\`\`\`
+/j.finish-setup
+\`\`\`
+
+## What happens
+
+### Phase 1 — Structural Scan (via @j.explore)
+
+1. Invoke \`@j.explore\` to scan the entire codebase
+2. Identify recurring file patterns by suffix/convention:
+   - \`*Repository.ts\`, \`*Repository.java\`, \`*Repository.kt\`, \`*_repository.py\` → pattern "repository"
+   - \`*Service.ts\`, \`*Service.java\`, \`*Service.kt\`, \`*_service.py\` → pattern "service"
+   - \`*Controller.ts\`, \`*Controller.java\`, \`*Controller.kt\` → pattern "controller"
+   - \`*Handler.go\`, \`*handler.go\` → pattern "handler"
+   - \`*Middleware.*\` → pattern "middleware"
+   - \`*Schema.*\`, \`*Model.*\` → pattern "model/schema"
+   - \`*DTO.*\`, \`*Request.*\`, \`*Response.*\` → pattern "dto"
+   - \`*Factory.*\`, \`*Builder.*\` → pattern "factory/builder"
+   - Any other recurring naming pattern (\`*Hook.ts\`, \`*Composable.ts\`, \`*Store.ts\`, etc.)
+3. For each pattern found, read 2-3 exemplar files and extract:
+   - Common structure (imports, exports, class vs function)
+   - Naming conventions
+   - Dependency patterns (what it injects, what it returns)
+   - Error handling patterns
+   - Validation patterns
+
+### Phase 2 — Generate Dynamic Skills
+
+4. For each discovered pattern, create a skill in \`.opencode/skills/j.{pattern}-writing/SKILL.md\`:
+   - Frontmatter with \`name\`, \`description\`
+   - "When this skill activates" with the glob patterns from the project
+   - "Required Steps" extracted from the exemplar file analysis
+   - "Anti-patterns to avoid" based on what the exemplars do NOT do
+   - Canonical example copied/adapted from a real project file
+5. Update \`.opencode/state/skill-map.json\` with new regex patterns for each skill
+
+### Phase 3 — Generate Documentation
+
+6. Generate initial docs in \`docs/domain/\` (subdirectories by discovered domain)
+7. Generate initial docs in \`docs/principles/\` based on patterns found
+8. Populate \`docs/principles/manifest\` with real keywords
+9. Populate \`docs/domain/INDEX.md\` with real entries and CARL keywords
+10. Update root \`AGENTS.md\` with discovered information (stack, build commands, test commands, directory layout)
+
+## Delegation Rule (MANDATORY)
+
+You MUST use \`@j.explore\` for Phase 1. Do NOT try to scan the codebase yourself.
+
+When \`@j.explore\` returns its report:
+- Read the FULL report
+- Extract all file patterns and structural findings
+- Use them to generate skills and docs
+
+## When to use
+
+- After initial \`juninho setup\` to customize skills for the specific project
+- After major structural refactors that introduce new file patterns
+- When onboarding a new project to the framework
+
+## Result
+
+After completion, the project will have:
+- Custom skills that match its specific file patterns and conventions
+- Domain documentation populated with real business domains
+- Principles documentation reflecting actual codebase patterns
+- An updated AGENTS.md with project-specific information
 `;
 //# sourceMappingURL=commands.js.map

package/dist/templates/commands.js.map

@@ -1 +1 @@
-{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/templates/commands.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/templates/commands.ts"],"names":[],"mappings":"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"}

package/dist/templates/docs.d.ts

@@ -1,8 +1,9 @@
+import type { ProjectType } from "../project-types.js";
 export interface OpencodeModels {
     strong: string;
     medium: string;
     weak: string;
 }
-export declare function writeDocs(projectDir: string): void;
+export declare function writeDocs(projectDir: string, projectType?: ProjectType, isKotlin?: boolean): void;
 export declare function patchOpencodeJson(projectDir: string, models?: OpencodeModels): void;
 //# sourceMappingURL=docs.d.ts.map

package/dist/templates/docs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/templates/docs.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;CACb;AAED,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CASlD;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,IAAI,CA2HnF"}
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/templates/docs.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAGtD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;CACb;AAED,wBAAgB,SAAS,CACvB,UAAU,EAAE,MAAM,EAClB,WAAW,GAAE,WAA2B,EACxC,QAAQ,GAAE,OAAe,GACxB,IAAI,CASN;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,IAAI,CAgInF"}

package/dist/templates/docs.js

@@ -8,8 +8,9 @@ exports.patchOpencodeJson = patchOpencodeJson;
 const fs_1 = require("fs");
 const path_1 = __importDefault(require("path"));
 const models_js_1 = require("../models.js");
-function writeDocs(projectDir) {
-    (0, fs_1.writeFileSync)(path_1.default.join(projectDir, "AGENTS.md"), AGENTS_MD);
+const project_types_js_1 = require("../project-types.js");
+function writeDocs(projectDir, projectType = "node-nextjs", isKotlin = false) {
+    (0, fs_1.writeFileSync)(path_1.default.join(projectDir, "AGENTS.md"), agentsMd(projectType, isKotlin));
     (0, fs_1.writeFileSync)(path_1.default.join(projectDir, "docs", "domain", "INDEX.md"), DOMAIN_INDEX);
     (0, fs_1.writeFileSync)(path_1.default.join(projectDir, "docs", "principles", "manifest"), MANIFEST);
     (0, fs_1.writeFileSync)(path_1.default.join(projectDir, "docs", "principles", "auth-patterns.md"), AUTH_PATTERNS);
@@ -39,6 +40,11 @@ function patchOpencodeJson(projectDir, models) {
                 type: "local",
                 command: ["npx", "-y", "@upstash/context7-mcp@latest"],
             },
+            // context-mode provides intelligent context management for agent sessions.
+            "context-mode": {
+                type: "local",
+                command: ["npx", "-y", "context-mode@latest"],
+            },
         },
         agent: {
             // Permission model from framework Section 27.
@@ -159,10 +165,56 @@ function deepMerge(base, override) {
     }
     return result;
 }
-// ─── AGENTS.md ────────────────────────────────────────────────────────────────
-const AGENTS_MD = `# AGENTS.md
+// ─── AGENTS.md (parameterized by project type) ──────────────────────────────
+function skillsTable(projectType, isKotlin) {
+    const config = project_types_js_1.PROJECT_TYPE_REGISTRY[projectType];
+    const rows = [];
+    const skillActivations = {
+        "j.test-writing": getTestSkillRow(projectType, isKotlin),
+        "j.page-creation": { pattern: "`app/**/page.tsx`", notes: "Stack-specific; Next.js App Router only" },
+        "j.api-route-creation": { pattern: "`app/api/**/*.ts`", notes: "" },
+        "j.server-action-creation": { pattern: "`**/actions.ts`", notes: "Stack-specific; Next.js Server Actions only" },
+        "j.schema-migration": { pattern: "`schema.prisma`", notes: "" },
+        "j.agents-md-writing": { pattern: "`**/AGENTS.md`", notes: "Directory-local agent guidance" },
+        "j.domain-doc-writing": { pattern: "`docs/domain/**/*.md`", notes: "Business behavior and sync markers" },
+        "j.principle-doc-writing": { pattern: "`docs/principles/**`", notes: "Cross-cutting technical rules" },
+        "j.shell-script-writing": { pattern: "`.opencode/scripts/**/*.sh`, `scripts/**/*.sh`, hooks", notes: "Fast, safe automation scripts" },
+    };
+    for (const skill of config.skills) {
+        const info = skillActivations[skill];
+        if (!info)
+            continue;
+        rows.push(`| \`${skill}\` | ${info.pattern} | ${info.notes} |`);
+    }
+    return rows.join("\n");
+}
+function getTestSkillRow(projectType, isKotlin) {
+    if (projectType === "java" && isKotlin) {
+        return { pattern: "`*Test.kt`, `*Tests.kt`, `*Test.java`", notes: "Kotlin/JUnit 5 + MockK/Mockito-Kotlin" };
+    }
+    switch (projectType) {
+        case "node-nextjs":
+        case "node-generic":
+            return { pattern: "`*.test.ts`, `*.spec.ts`", notes: "Jest/Vitest AAA pattern" };
+        case "python":
+            return { pattern: "`test_*.py`, `*_test.py`", notes: "pytest + unittest.mock" };
+        case "go":
+            return { pattern: "`*_test.go`", notes: "table-driven tests with t.Run" };
+        case "java":
+            return { pattern: "`*Test.java`, `*Tests.java`", notes: "JUnit 5 + Mockito" };
+        case "generic":
+        default:
+            return { pattern: "test files", notes: "AAA pattern" };
+    }
+}
+function agentsMd(projectType, isKotlin) {
+    const stackLabel = projectType === "java" && isKotlin ? "Java/Kotlin" : projectType;
+    const skillCount = project_types_js_1.PROJECT_TYPE_REGISTRY[projectType].skills.length;
+    const commandCount = 15; // 14 original + finish-setup
+    return `# AGENTS.md
 
 This project uses the **Agentic Coding Framework** v2.1 — installed by [juninho](https://github.com/KleberMotta/juninho).
+Project type: **${stackLabel}**
 
 ## Workflows
 
@@ -199,6 +251,7 @@ This project uses the **Agentic Coding Framework** v2.1 — installed by [juninh
 | \`/j.handoff\` | Prepare end-of-session handoff doc |
 | \`/j.init-deep\` | Generate hierarchical AGENTS.md + populate domain docs |
 | \`/j.ulw-loop\` | Maximum parallelism mode |
+| \`/j.finish-setup\` | Scan codebase, generate dynamic skills from file patterns, populate domain/principles docs |
 
 ## Agent Roster
 
@@ -237,7 +290,7 @@ Maps files, patterns, and constraints before the developer interview.
 
 ### @j.librarian
 External docs and OSS research. Spawned by planner Phase 1.
-Fetches official API docs via Context7 MCP.
+Fetches official API docs via Context7 MCP and context-mode MCP.
 
 ## Context Tiers
 
@@ -285,15 +338,7 @@ Fetches official API docs via Context7 MCP.
 
 | Skill | Activates on | Notes |
 |-------|-------------|-------|
-| \`j.test-writing\` | \`*.test.ts\`, \`*.spec.ts\` | Optional: uncomment Playwright MCP in frontmatter for E2E |
-| \`j.page-creation\` | \`app/**/page.tsx\` | Stack-specific; use only on Next.js App Router repos |
-| \`j.api-route-creation\` | \`app/api/**/*.ts\` | |
-| \`j.server-action-creation\` | \`**/actions.ts\` | Stack-specific; use only on Next.js Server Actions repos |
-| \`j.schema-migration\` | \`schema.prisma\` | |
-| \`j.agents-md-writing\` | \`**/AGENTS.md\` | Directory-local agent guidance |
-| \`j.domain-doc-writing\` | \`docs/domain/**/*.md\` | Business behavior and sync markers |
-| \`j.principle-doc-writing\` | \`docs/principles/**\` | Cross-cutting technical rules |
-| \`j.shell-script-writing\` | \`.opencode/scripts/**/*.sh\`, \`scripts/**/*.sh\`, hooks | Fast, safe automation scripts |
+${skillsTable(projectType, isKotlin)}
 
 ## State Files
 
@@ -304,6 +349,7 @@ Fetches official API docs via Context7 MCP.
 | \`.opencode/state/validator-work.md\` | Validator audit trail — BLOCK/FIX/NOTE per pass |
 | \`.opencode/state/implementer-work.md\` | Implementer decisions and blockers log |
 | \`.opencode/state/workflow-config.md\` | Controls handoff, doc sync, and configurable UNIFY behavior |
+| \`.opencode/state/skill-map.json\` | Dynamic skill-to-pattern mapping — extended by /j.finish-setup |
 | \`.opencode/state/.plan-ready\` | Transient IPC flag — plan path, consumed by plan-autoload |
 
 ## Conventions
@@ -315,6 +361,7 @@ Fetches official API docs via Context7 MCP.
 - Worktrees: \`worktrees/{feature}-{task}/\` — created by implementer, removed by UNIFY
 - Hierarchical \`AGENTS.md\`: root + \`src/\` + \`src/{module}/\` — generated by \`/j.init-deep\`
 `;
+}
 // ─── Domain INDEX.md ──────────────────────────────────────────────────────────
 const DOMAIN_INDEX = `# Domain Index