agentpack-cli 0.3.26__tar.gz → 0.3.29__tar.gz

{agentpack_cli-0.3.26 → agentpack_cli-0.3.29}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentpack-cli
-Version: 0.3.26
+Version: 0.3.29
 Summary: Local context engine for AI coding agents that ranks relevant repo files and builds compact task-focused context packs for Claude Code, Codex, Cursor, Windsurf, MCP, and CI workflows.
 Project-URL: Homepage, https://github.com/vishal2612200/agentpack
 Project-URL: Documentation, https://vishal2612200.github.io/agentpack/
@@ -60,6 +60,7 @@ Description-Content-Type: text/markdown
 </p>
 
 <p align="center">
+  <a href="https://deepwiki.com/vishal2612200/agentpack"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>
   <a href="https://pypi.org/project/agentpack-cli/"><img alt="PyPI version" src="https://img.shields.io/pypi/v/agentpack-cli.svg"></a>
   <a href="https://pepy.tech/projects/agentpack-cli"><img alt="PyPI downloads" src="https://static.pepy.tech/personalized-badge/agentpack-cli?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=GREEN&left_text=downloads"></a>
   <a href="https://www.npmjs.com/package/@vishal2612200/agentpack"><img alt="npm version" src="https://img.shields.io/npm/v/@vishal2612200/agentpack.svg"></a>

{agentpack_cli-0.3.26 → agentpack_cli-0.3.29}/README.md

@@ -13,6 +13,7 @@
 </p>
 
 <p align="center">
+  <a href="https://deepwiki.com/vishal2612200/agentpack"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>
   <a href="https://pypi.org/project/agentpack-cli/"><img alt="PyPI version" src="https://img.shields.io/pypi/v/agentpack-cli.svg"></a>
   <a href="https://pepy.tech/projects/agentpack-cli"><img alt="PyPI downloads" src="https://static.pepy.tech/personalized-badge/agentpack-cli?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=GREEN&left_text=downloads"></a>
   <a href="https://www.npmjs.com/package/@vishal2612200/agentpack"><img alt="npm version" src="https://img.shields.io/npm/v/@vishal2612200/agentpack.svg"></a>

{agentpack_cli-0.3.26 → agentpack_cli-0.3.29}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agentpack-cli"
-version = "0.3.26"
+version = "0.3.29"
 description = "Local context engine for AI coding agents that ranks relevant repo files and builds compact task-focused context packs for Claude Code, Codex, Cursor, Windsurf, MCP, and CI workflows."
 readme = "README.md"
 requires-python = ">=3.10"

{agentpack_cli-0.3.26 → agentpack_cli-0.3.29}/src/agentpack/__init__.py

@@ -1,3 +1,3 @@
 """AgentPack — task-aware context packing for AI coding agents."""
 
-__version__ = "0.3.26"
+__version__ = "0.3.29"

{agentpack_cli-0.3.26 → agentpack_cli-0.3.29}/src/agentpack/adapters/codex.py

@@ -25,5 +25,8 @@ class CodexAdapter(BaseAdapter):
     def patch_codex_hooks(self, root: Path) -> str:
         return CodexInstaller().patch_codex_hooks(root)
 
+    def patch_codex_mcp_config(self, *, codex_home: Path | None = None) -> str:
+        return CodexInstaller().patch_codex_mcp_config(codex_home=codex_home)
+
     def install_auto_repack(self, root: Path) -> dict[str, str]:
         return CodexInstaller().install_auto_repack(root)

{agentpack_cli-0.3.26 → agentpack_cli-0.3.29}/src/agentpack/application/pack_service.py

@@ -67,6 +67,7 @@ from agentpack.analysis.tests import find_related_tests
 from agentpack.analysis import dependency_graph as dep_graph_mod
 from agentpack.summaries.base import build_all_summaries
 from agentpack.session.events import record_event
+from agentpack.session.references import collect_repo_issue_references
 
 
 @dataclass
@@ -829,11 +830,14 @@ class PackService:
             output_path=cfg.runtime.pack_registry_output,
             max_records=cfg.runtime.max_registry_records,
         )
+        issue_reference_details = collect_repo_issue_references(root, request.task)
         record_event(
             root,
             "pack",
             {
                 "task": request.task,
+                "issue_references": [item.ref for item in issue_reference_details],
+                "issue_reference_details": [item.to_dict() for item in issue_reference_details],
                 "agent": request.agent,
                 "mode": plan.mode,
                 "packed_tokens": packed_tokens,

{agentpack_cli-0.3.26 → agentpack_cli-0.3.29}/src/agentpack/commands/doctor.py

@@ -321,7 +321,7 @@ def register(app: typer.Typer) -> None:
         if findings:
             for finding in findings:
                 console.print(f"  [yellow]![/] {finding}")
-            ok = False
+            console.print("  [dim]warning only; keep these out of commits/releases.[/]")
         else:
             console.print("  [green]✓[/] no generated release-noise files staged or untracked")
 
@@ -334,18 +334,25 @@ def register(app: typer.Typer) -> None:
         else:
             console.print("  [green]✓[/] npm publish token available in environment")
 
-        # --- Slash command ---
-        console.print("\n[bold]Slash command (/agentpack)[/]")
-        local_cmd = root / ".claude" / "commands" / "agentpack.md"
-        global_cmd = Path.home() / ".claude" / "commands" / "agentpack.md"
-        if local_cmd.exists():
-            console.print(f"  [green]✓[/] Slash command installed (local): {local_cmd}")
-        else:
-            console.print("  [dim]-[/] Slash command not installed locally — run: agentpack install --agent claude")
-        if global_cmd.exists():
-            console.print(f"  [green]✓[/] Slash command installed (global): {global_cmd}")
-        else:
-            console.print("  [dim]-[/] Slash command not installed globally — run: agentpack install --agent claude --global")
+        # --- Slash commands ---
+        console.print("\n[bold]Slash commands (/agentpack, /agentpack-learn)[/]")
+        for filename in ("agentpack.md", "agentpack-learn.md"):
+            local_cmd = root / ".claude" / "commands" / filename
+            global_cmd = Path.home() / ".claude" / "commands" / filename
+            if local_cmd.exists():
+                console.print(f"  [green]✓[/] Slash command installed (local): {local_cmd}")
+            else:
+                console.print(
+                    f"  [dim]-[/] Slash command not installed locally: {local_cmd} — "
+                    "run: agentpack install --agent claude"
+                )
+            if global_cmd.exists():
+                console.print(f"  [green]✓[/] Slash command installed (global): {global_cmd}")
+            else:
+                console.print(
+                    f"  [dim]-[/] Slash command not installed globally: {global_cmd} — "
+                    "run: agentpack install --agent claude --global"
+                )
 
         _print_summary(ok)
 

{agentpack_cli-0.3.26 → agentpack_cli-0.3.29}/src/agentpack/commands/init.py

@@ -206,6 +206,10 @@ def _patch_agentignore(
 
 def _install_agent_integration(root, agent: str) -> dict[str, str]:
     """Install repo-local agent integration files after `agentpack init`."""
+    if agent == "claude":
+        from agentpack.commands.install import _install_slash_command
+
+        return install_agent_integration(root, agent, install_slash_command=_install_slash_command)
     return install_agent_integration(root, agent)
 
 
@@ -246,7 +250,13 @@ def _resolve_init_agent(root: Path, agent: str, *, force: bool = False) -> str:
 
 def _agent_integration_paths(agent: str) -> tuple[str, ...]:
     if agent == "claude":
-        return ("CLAUDE.md", ".claude/settings.json", ".mcp.json")
+        return (
+            "CLAUDE.md",
+            ".claude/settings.json",
+            ".mcp.json",
+            ".claude/commands/agentpack.md",
+            ".claude/commands/agentpack-learn.md",
+        )
     if agent == "cursor":
         return (".cursorrules", ".cursor/rules/agentpack.mdc", ".vscode/tasks.json")
     if agent == "windsurf":

{agentpack_cli-0.3.26 → agentpack_cli-0.3.29}/src/agentpack/commands/install.py

@@ -47,8 +47,8 @@ def _print_install_results(agent: str, results: dict[str, str]) -> None:
             console.print(f"[green].git/hooks/{key[4:]} {action}.[/]")
         elif key == "vscode:tasks":
             console.print(f"[green].vscode/tasks.json {action}.[/]")
-        elif key == "/agentpack":
-            console.print(f"[green]/agentpack slash command {action}.[/]")
+        elif key.startswith("/"):
+            console.print(f"[green]{key} slash command {action}.[/]")
         else:
             console.print(f"[green]{key} {action}.[/]")
 
@@ -66,7 +66,7 @@ def _print_dry_run_agent(agent: str) -> None:
     elif agent == "windsurf":
         console.print("\n[dim]Would patch: .windsurfrules, VS Code task, git hooks[/]")
     elif agent == "codex":
-        console.print("\n[dim]Would patch: AGENTS.md, .codex/hooks.json, git hooks[/]")
+        console.print("\n[dim]Would patch: AGENTS.md, .codex/hooks.json, Codex MCP config, git hooks[/]")
     elif agent == "antigravity":
         console.print("\n[dim]Would patch: GEMINI.md, VS Code task, git hooks[/]")
     elif agent == "generic":
@@ -256,18 +256,24 @@ def register(app: typer.Typer) -> None:
             console.print("  Current repo hooks now delegate through AgentPack's safe GitAutoRepack path.")
 
 
-def _install_slash_command(root: Path, global_install: bool) -> str:
-    import importlib.resources
-
+def _install_slash_command(root: Path, global_install: bool) -> dict[str, str]:
     commands_dir = Path.home() / ".claude" / "commands" if global_install else root / ".claude" / "commands"
     commands_dir.mkdir(parents=True, exist_ok=True)
-    dest = commands_dir / "agentpack.md"
+    return {
+        "/agentpack": _install_slash_command_file(commands_dir, "agentpack.md"),
+        "/agentpack-learn": _install_slash_command_file(commands_dir, "agentpack-learn.md"),
+    }
+
+
+def _install_slash_command_file(commands_dir: Path, filename: str) -> str:
+    import importlib.resources
 
+    dest = commands_dir / filename
     try:
-        pkg_files = importlib.resources.files("agentpack") / "data" / "agentpack.md"
+        pkg_files = importlib.resources.files("agentpack") / "data" / filename
         source_text = pkg_files.read_text(encoding="utf-8")
     except Exception:
-        source_text = (Path(__file__).parent.parent / "data" / "agentpack.md").read_text(encoding="utf-8")
+        source_text = (Path(__file__).parent.parent / "data" / filename).read_text(encoding="utf-8")
 
     existed = dest.exists()
     if existed and dest.read_text(encoding="utf-8") == source_text:

{agentpack_cli-0.3.26 → agentpack_cli-0.3.29}/src/agentpack/commands/learn.py

@@ -248,6 +248,8 @@ def register(app: typer.Typer) -> None:
             "learn",
             {
                 "task": report.task,
+                "issue_references": report.issue_references,
+                "issue_reference_details": report.issue_reference_details,
                 "changed_files": len(report.source_files),
                 "concepts": report.concepts,
                 "selected_hits": len(report.selected_hits),

{agentpack_cli-0.3.26 → agentpack_cli-0.3.29}/src/agentpack/commands/memory.py

@@ -9,6 +9,7 @@ from rich import box
 
 from agentpack.commands._shared import _root, console
 from agentpack.core.config import load_config
+from agentpack.session.references import merge_issue_reference_objects, merge_issue_references
 from agentpack.session.events import read_events
 
 
@@ -26,8 +27,29 @@ def register(app: typer.Typer) -> None:
             for concept in (event.get("concepts") or [])
             if isinstance(concept, str)
         )
+        issue_references = merge_issue_references(
+            ref
+            for event in events
+            for ref in (event.get("issue_references") or [])
+            if isinstance(ref, str)
+        )
+        top_issue_references = Counter(
+            ref
+            for event in events
+            for ref in (event.get("issue_references") or [])
+            if isinstance(ref, str)
+        ).most_common(20)
+        issue_reference_details = merge_issue_reference_objects(
+            item
+            for event in events
+            for item in (event.get("issue_reference_details") or [])
+            if isinstance(item, dict)
+        )
         payload = {
             "recent_tasks": tasks[-20:],
+            "recent_issue_references": issue_references[-20:],
+            "issue_reference_details": [item.to_dict() for item in issue_reference_details[-20:]],
+            "top_issue_references": top_issue_references,
             "top_concepts": concepts.most_common(20),
             "event_count": len(events),
         }
@@ -40,6 +62,15 @@ def register(app: typer.Typer) -> None:
         table.add_row("events", str(len(events)))
         for task in tasks[-10:]:
             table.add_row("task", task)
+        for ref in issue_references[-10:]:
+            table.add_row("issue", ref)
+        for item in issue_reference_details[-10:]:
+            label = item.ref
+            if item.title:
+                label += f" — {item.title}"
+            if item.state:
+                label += f" ({item.state})"
+            table.add_row("issue detail", label)
         for concept, count in concepts.most_common(10):
             table.add_row("concept", f"{concept} ({count})")
         console.print(table)

agentpack_cli-0.3.29/src/agentpack/commands/upgrade.py

@@ -0,0 +1,93 @@
+from __future__ import annotations
+
+import subprocess
+
+import typer
+
+from agentpack.commands._shared import console, _root
+from agentpack.commands.install import (
+    _install_slash_command,
+    _print_global_template_results,
+    _print_install_results,
+)
+from agentpack.integrations import global_install as global_hooks
+from agentpack.integrations.agents import SUPPORTED_AGENTS, expand_agents, install_agent_integration
+
+
+def register(app: typer.Typer) -> None:
+    @app.command()
+    def upgrade(
+        agent: str = typer.Option(
+            "auto",
+            "--agent",
+            help=f"Agent integration to refresh after package upgrade ({' | '.join(SUPPORTED_AGENTS)}).",
+        ),
+        repair_existing_global_hooks: bool = typer.Option(
+            True,
+            "--repair-existing-global-hooks/--no-repair-existing-global-hooks",
+            help="Refresh already-installed global git/shell hooks after upgrading AgentPack.",
+        ),
+    ) -> None:
+        """Refresh existing AgentPack repo/global integration surfaces after a package upgrade."""
+        root = _root()
+        if agent not in SUPPORTED_AGENTS:
+            console.print(f"[yellow]Unknown agent: {agent}. Supported: {', '.join(SUPPORTED_AGENTS)}[/]")
+            raise typer.Exit(1)
+
+        agents = expand_agents(agent, root)
+        if agent == "auto":
+            console.print(f"[dim]Auto-detected agent: {agents[0]}[/]")
+
+        for selected in agents:
+            console.print(f"\n[bold]{selected}[/]")
+            results = install_agent_integration(
+                root,
+                selected,
+                install_slash_command=_install_slash_command,
+            )
+            _print_install_results(selected, results)
+
+        if repair_existing_global_hooks:
+            _repair_existing_global_hooks()
+
+        console.print("\n[bold green]Upgrade integration refresh complete.[/]")
+        console.print(f"  Verify with: [bold]agentpack doctor --agent {agent}[/]")
+
+
+def _repair_existing_global_hooks() -> None:
+    repaired = False
+    if _global_git_templates_are_installed():
+        repaired = True
+        console.print("\n[bold]Refreshing existing global git template hooks...[/]")
+        hook_results = global_hooks.install_git_template_hooks()
+        _print_global_template_results(hook_results)
+        git_cfg_action = global_hooks.configure_git_template_dir(dry_run=False)
+        console.print(f"[green]git config --global init.templateDir {git_cfg_action}.[/]")
+
+    rc_file = global_hooks._detect_rc_file()
+    if rc_file is not None and rc_file.exists() and global_hooks._SHELL_MARKER_START in rc_file.read_text(encoding="utf-8"):
+        repaired = True
+        console.print("\n[bold]Refreshing existing shell cd hook...[/]")
+        action, path = global_hooks.install_shell_hook(rc_file)
+        if path is not None:
+            console.print(f"[green]{path} {action}.[/]")
+
+    if not repaired:
+        console.print("\n[dim]No existing global AgentPack hooks found to refresh.[/]")
+
+
+def _global_git_templates_are_installed() -> bool:
+    hooks_dir = global_hooks._GIT_TEMPLATE_DIR / "hooks"
+    for name in global_hooks._HOOK_SCRIPTS:
+        hook_path = hooks_dir / name
+        if hook_path.exists() and global_hooks._AGENTPACK_MARKER in hook_path.read_text(encoding="utf-8"):
+            return True
+    try:
+        result = subprocess.run(
+            ["git", "config", "--global", "init.templateDir"],
+            capture_output=True,
+            text=True,
+        )
+    except Exception:
+        return False
+    return result.stdout.strip() == str(global_hooks._GIT_TEMPLATE_DIR)

{agentpack_cli-0.3.26 → agentpack_cli-0.3.29}/src/agentpack/core/command_surface.py

@@ -73,6 +73,15 @@ def fallback_agent_guidance() -> str:
     )
 
 
+def prompt_quality_guidance() -> str:
+    return (
+        "Prompt hygiene: for agent-mode coding work, prefer `Task`, `Files`, "
+        "`Acceptance criteria`, `Constraints`, `Validation`, and `Output` sections. "
+        "For short/simple questions, use Ask/Chat mode instead of agent mode. "
+        "Keep routine responses concise unless the user asks for detail."
+    )
+
+
 def installed_cli_status() -> dict[str, object]:
     binary = shutil.which("agentpack")
     status: dict[str, object] = {
@@ -113,7 +122,7 @@ def _commands_from_help(text: str) -> list[str]:
     commands: set[str] = set()
     known = set(available_cli_commands())
     for line in text.splitlines():
-        stripped = line.strip()
+        stripped = line.strip().strip("│").strip()
         if not stripped:
             continue
         first = stripped.split()[0].strip("`")

agentpack_cli-0.3.29/src/agentpack/data/agentpack-learn.md

@@ -0,0 +1,66 @@
+---
+description: Learn one thing from the current local AgentPack session context.
+---
+
+# AgentPack Learn
+
+Use current local agent session context to teach what the user asks to learn.
+
+Keep this prompt prefix stable for caching. Do not move the user learning statement above the final line.
+
+## Freshness Check
+
+Check whether current AgentPack context is present and current:
+
+```bash
+agentpack status
+```
+
+If `agentpack status` fails, says context is stale/missing, or `.agentpack/context.compact.md` is absent, refresh once:
+
+```bash
+agentpack pack --task auto
+```
+
+Do not loop on refresh. If refresh fails, continue from whatever local context exists and state that context may be stale.
+
+## Context Source
+
+Use only local files first:
+
+```bash
+test -f .agentpack/context.compact.md && sed -n '1,220p' .agentpack/context.compact.md
+test -f .agentpack/task.md && sed -n '1,40p' .agentpack/task.md
+test -f .agentpack/session.json && sed -n '1,120p' .agentpack/session.json
+test -f .agentpack/learning.md && sed -n '1,220p' .agentpack/learning.md
+test -f .agentpack/agent-lessons.md && sed -n '1,160p' .agentpack/agent-lessons.md
+test -f .agentpack/skills-progress.json && sed -n '1,120p' .agentpack/skills-progress.json
+test -f .agentpack/session-events.jsonl && tail -n 40 .agentpack/session-events.jsonl
+```
+
+Use `.agentpack/context.md` only when compact context lacks needed detail.
+Do not invent repo facts not present in local context or checked files.
+
+## Teaching Modes
+
+Choose the smallest mode that matches the user's learning statement.
+
+Learning Curve Destroyer: use when user wants to become functional fast. You only have 4 hours with them and will never see them again. No theory without practical use. No lists. Tell them what to learn first, what to ignore, and one exercise that puts them ahead of most people studying for months.
+
+Real Error Simulator: use when user wants practice with a concept. Do not explain first. Drop them into a real situation from local context where they would use it and likely get it wrong. When they make a mistake, ask a question that exposes where thinking broke. Reveal answer only after at least two tries. Repeat until they get it right without hesitating.
+
+Confusion Breaker: use when user says content or context is confusing. Before explaining, give one sentence that makes everything click. Explain only that sentence first using an everyday analogy with zero technical terms. Ask 3 questions only someone who truly gets it can answer. Do not move on until they pass all three.
+
+Personal Learning Path: use when user gives a real goal, desired result, deadline, or current knowledge. Build a 7-day path. Each day has one 45-minute task, a clear correctness check, and what not to do that day. If path does not lead to goal, rebuild it.
+
+Forced Feynman Method: use when user says they studied something or wants to explain back. Let them explain as if to a 10-year-old. Stop them when they use unknown words, skip reasoning, or oversimplify until wrong. End with exactly what mistakes reveal about weak understanding.
+
+## Output Rules
+
+- Be practical and interactive.
+- Ground examples in local agent session context when useful.
+- Ask for missing goal/deadline/current-knowledge only if needed for the selected mode.
+- Do not dump generic theory.
+- Do not produce long lists unless the selected mode explicitly requires a 7-day path.
+
+User learning statement: $ARGUMENTS

{agentpack_cli-0.3.26 → agentpack_cli-0.3.29}/src/agentpack/data/codex_plugin/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agentpack",
-  "version": "0.3.26",
+  "version": "0.3.29",
   "description": "Thin Codex plugin for AgentPack ranked repo context.",
   "author": {
     "name": "AgentPack",
@@ -29,6 +29,7 @@
     "defaultPrompt": [
       "@agentpack-route fix auth token expiry",
       "@agentpack-pack fix auth token expiry",
+      "@agentpack-learn retry handling in this repo",
       "@agentpack-review"
     ],
     "brandColor": "#1F6FEB"

agentpack_cli-0.3.29/src/agentpack/data/codex_plugin/skills/agentpack-learn.md

@@ -0,0 +1,67 @@
+---
+name: agentpack-learn
+description: Learn one thing from current local AgentPack session context.
+---
+
+# AgentPack Learn
+
+Use when the user invokes `/agentpack-learn <statement>` or `@agentpack-learn <statement>`.
+
+Use current local agent session context to teach what the user asks to learn.
+
+Keep prompt prefix stable for caching. Treat the user's learning statement as the only variable and keep it at the end when constructing any reusable prompt.
+
+## Freshness Check
+
+Check whether current AgentPack context is present and current:
+
+```bash
+agentpack status
+```
+
+If `agentpack status` fails, says context is stale/missing, or `.agentpack/context.compact.md` is absent, refresh once:
+
+```bash
+agentpack pack --task auto
+```
+
+Do not loop on refresh. If refresh fails, continue from whatever local context exists and state that context may be stale.
+
+## Context Source
+
+Use only local files first:
+
+```bash
+test -f .agentpack/context.compact.md && sed -n '1,220p' .agentpack/context.compact.md
+test -f .agentpack/task.md && sed -n '1,40p' .agentpack/task.md
+test -f .agentpack/session.json && sed -n '1,120p' .agentpack/session.json
+test -f .agentpack/learning.md && sed -n '1,220p' .agentpack/learning.md
+test -f .agentpack/agent-lessons.md && sed -n '1,160p' .agentpack/agent-lessons.md
+test -f .agentpack/skills-progress.json && sed -n '1,120p' .agentpack/skills-progress.json
+test -f .agentpack/session-events.jsonl && tail -n 40 .agentpack/session-events.jsonl
+```
+
+Use `.agentpack/context.md` only when compact context lacks needed detail.
+Do not invent repo facts not present in local context or checked files.
+
+## Teaching Modes
+
+Choose the smallest mode that matches the user's learning statement.
+
+Learning Curve Destroyer: use when user wants to become functional fast. You only have 4 hours with them and will never see them again. No theory without practical use. No lists. Tell them what to learn first, what to ignore, and one exercise that puts them ahead of most people studying for months.
+
+Real Error Simulator: use when user wants practice with a concept. Do not explain first. Drop them into a real situation from local context where they would use it and likely get it wrong. When they make a mistake, ask a question that exposes where thinking broke. Reveal answer only after at least two tries. Repeat until they get it right without hesitating.
+
+Confusion Breaker: use when user says content or context is confusing. Before explaining, give one sentence that makes everything click. Explain only that sentence first using an everyday analogy with zero technical terms. Ask 3 questions only someone who truly gets it can answer. Do not move on until they pass all three.
+
+Personal Learning Path: use when user gives a real goal, desired result, deadline, or current knowledge. Build a 7-day path. Each day has one 45-minute task, a clear correctness check, and what not to do that day. If path does not lead to goal, rebuild it.
+
+Forced Feynman Method: use when user says they studied something or wants to explain back. Let them explain as if to a 10-year-old. Stop them when they use unknown words, skip reasoning, or oversimplify until wrong. End with exactly what mistakes reveal about weak understanding.
+
+## Output Rules
+
+- Be practical and interactive.
+- Ground examples in local agent session context when useful.
+- Ask for missing goal/deadline/current-knowledge only if needed for the selected mode.
+- Do not dump generic theory.
+- Do not produce long lists unless the selected mode explicitly requires a 7-day path.

{agentpack_cli-0.3.26 → agentpack_cli-0.3.29}/src/agentpack/installers/antigravity.py

@@ -3,7 +3,7 @@ from __future__ import annotations
 import re
 from pathlib import Path
 
-from agentpack.core.command_surface import fallback_agent_guidance, refresh_commands
+from agentpack.core.command_surface import fallback_agent_guidance, prompt_quality_guidance, refresh_commands
 from agentpack.integrations.git_hooks import install_git_hooks
 from agentpack.integrations.vscode_tasks import install_vscode_tasks
 
@@ -31,7 +31,9 @@ At the start of every coding task:
 
 When the user switches to a different coding task, update `.agentpack/task.md`, then call MCP again or rerun the refresh command before editing.
 
-{fallback_agent_guidance()}{thread_line}
+{fallback_agent_guidance()}
+
+{prompt_quality_guidance()}{thread_line}
 <!-- agentpack:block:end -->"""
 
 _BLOCK_RE = re.compile(

{agentpack_cli-0.3.26 → agentpack_cli-0.3.29}/src/agentpack/installers/claude.py

@@ -4,7 +4,7 @@ import json
 import re
 from pathlib import Path
 
-from agentpack.core.command_surface import fallback_agent_guidance, refresh_commands
+from agentpack.core.command_surface import fallback_agent_guidance, prompt_quality_guidance, refresh_commands
 
 
 def _agentpack_block() -> str:
@@ -59,7 +59,9 @@ agentpack pack --agent claude --task auto
 
 Then read `.agentpack/context.claude.md`.
 
-{fallback_agent_guidance()}{thread_line}
+{fallback_agent_guidance()}
+
+{prompt_quality_guidance()}{thread_line}
 <!-- agentpack:end -->"""