agentxchain 0.8.8 → 2.2.0

package/src/templates/governed/cli-tool.json

@@ -0,0 +1,30 @@
+{
+  "id": "cli-tool",
+  "display_name": "CLI Tool",
+  "description": "Governed scaffold for command-line tools with command-surface, platform, and distribution planning.",
+  "version": "1",
+  "protocol_compatibility": ["1.0", "1.1"],
+  "planning_artifacts": [
+    {
+      "filename": "command-surface.md",
+      "content_template": "# Command Surface — {{project_name}}\n\n## Primary Commands\n| Command | Purpose | Inputs | Output / Side Effects |\n|---------|---------|--------|------------------------|\n| | | | |\n\n## Flags And Options\n| Command | Flag | Meaning | Default |\n|---------|------|---------|---------|\n| | | | |\n\n## Failure UX\n- Expected error messages:\n- Help / usage fallback:\n- Safe retry behavior:\n"
+    },
+    {
+      "filename": "platform-support.md",
+      "content_template": "# Platform Support — {{project_name}}\n\n## Supported Environments\n- Operating systems:\n- Shells / terminals:\n- Node / runtime versions:\n\n## Compatibility Risks\n| Surface | Risk | Mitigation |\n|---------|------|------------|\n| | | |\n\n## Manual Checks\n- Install path verified on:\n- Non-interactive behavior verified on:\n- Path / permission edge cases:\n"
+    },
+    {
+      "filename": "distribution-checklist.md",
+      "content_template": "# Distribution Checklist — {{project_name}}\n\n## Packaging\n- Package metadata reviewed:\n- Published files audited:\n- Version / changelog ready:\n\n## Install Paths\n- Global install path:\n- Local invocation path:\n- Upgrade / rollback path:\n\n## Release Risks\n- Breaking command changes:\n- Shell completion / docs gaps:\n- Known install blockers:\n"
+    }
+  ],
+  "prompt_overrides": {
+    "dev": "Treat help text, error messaging, shell compatibility, and safe invocation paths as product behavior, not polish.",
+    "qa": "Audit command UX, help output, failure messages, install or invocation paths, and shell/platform compatibility before sign-off."
+  },
+  "acceptance_hints": [
+    "Command help audited for every user-facing command touched",
+    "Install or invocation path checked on the intended runtime",
+    "Failure-mode UX reviewed for invalid flags or missing inputs"
+  ]
+}

package/src/templates/governed/generic.json

@@ -0,0 +1,10 @@
+{
+  "id": "generic",
+  "display_name": "Generic",
+  "description": "Default governed scaffold with the baseline planning artifacts and no project-type-specific guidance.",
+  "version": "1",
+  "protocol_compatibility": ["1.0", "1.1"],
+  "planning_artifacts": [],
+  "prompt_overrides": {},
+  "acceptance_hints": []
+}

package/src/templates/governed/web-app.json

@@ -0,0 +1,30 @@
+{
+  "id": "web-app",
+  "display_name": "Web App",
+  "description": "Governed scaffold for web products with user-flow, UI, and browser-support planning artifacts.",
+  "version": "1",
+  "protocol_compatibility": ["1.0", "1.1"],
+  "planning_artifacts": [
+    {
+      "filename": "user-flows.md",
+      "content_template": "# User Flows — {{project_name}}\n\n## Primary Flows\n| Flow | User goal | Entry point | Success state |\n|------|-----------|-------------|---------------|\n| | | | |\n\n## Failure And Recovery\n| Flow | Failure state | Recovery path |\n|------|---------------|---------------|\n| | | |\n"
+    },
+    {
+      "filename": "ui-acceptance.md",
+      "content_template": "# UI Acceptance — {{project_name}}\n\n## Screens / States\n| Surface | Happy path expectations | Empty / error states | Notes |\n|---------|-------------------------|----------------------|-------|\n| | | | |\n\n## Accessibility And Copy\n- Keyboard expectations:\n- Contrast / readability notes:\n- Copy review focus:\n"
+    },
+    {
+      "filename": "browser-support.md",
+      "content_template": "# Browser Support — {{project_name}}\n\n## Target Environments\n- Desktop browsers:\n- Mobile browsers:\n- Minimum viewport assumptions:\n\n## Compatibility Risks\n| Browser / device | Risk | Mitigation |\n|------------------|------|------------|\n| | | |\n\n## Smoke Checklist\n- Primary flow works on desktop:\n- Primary flow works on mobile:\n- Known degraded experiences:\n"
+    }
+  ],
+  "prompt_overrides": {
+    "pm": "Define the primary user flows and the minimum browser or device support up front. Vague UX scope will cause downstream churn.",
+    "qa": "Verify primary user flows, responsive behavior, accessibility smoke checks, and copy regressions. Do not treat visual breakage as a minor issue."
+  },
+  "acceptance_hints": [
+    "Primary user flow reviewed end to end",
+    "Mobile and desktop behavior checked explicitly",
+    "Accessibility or copy regressions noted before ship request"
+  ]
+}