@codebehind/agent-workflow 1.1.9 → 1.1.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codebehind/agent-workflow",
-  "version": "1.1.9",
+  "version": "1.1.10",
   "description": "Scaffold the agent-workflow spec-driven delivery framework into any repo",
   "type": "module",
   "bin": {

package/templates/.claude/skills/prepare-spec/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: prepare-spec
-description: Turn a Notion task or free-form request into a repository spec file, gather supporting assets, commit the result on a spec branch, and open or update a GitLab MR.
+description: Turn a Notion page, Google Drive doc, local file, or free-form request into a repository spec file, gather supporting assets, commit the result on a spec branch, and open or update a GitLab MR.
 ---
 
 Use this skill when the user wants a new spec created or an existing draft refined.
@@ -9,11 +9,19 @@ Use this skill when the user wants a new spec created or an existing draft refin
 Produce a clean implementation-ready spec in `.agent-workflow/specs/`, gather relevant supporting files in `.agent-workflow/specs/assets/<spec-slug>/`, and hand the result off through GitLab when the current session is running in the local GitLab workflow.
 
 ## Inputs
-Possible inputs:
-- pasted Notion task content
-- Notion page or subpage content available through connectors
+
+The source type is identified from the prompt. Fetch content accordingly:
+
+| Source | Identified by | How to fetch |
+|--------|--------------|--------------|
+| **Notion page** | Prompt says "from Notion page: `<url>`" | Use Notion MCP (`API-retrieve-a-page` or equivalent) |
+| **Google Drive doc** | Prompt says "from Google Drive document: `<url>`" | Use Google Drive MCP if available; otherwise use WebFetch to retrieve the document content |
+| **Local file** | Prompt says "from local file: `<path>`" | Use the Read tool to read the file directly |
+| **Free-form / pasted** | No prefix — content is provided inline | Use the content as-is |
+
+Additional input types that may accompany any of the above:
 - screenshots or JSON examples
-- short free-form feature request
+- short free-form feature description
 
 ## Required behavior
 1. Read `.agent-workflow/specs/_template.md` if present.

package/templates/agents-workflow-dev-process.md

@@ -59,30 +59,40 @@ Use `_template.md` when creating specs by hand.
 
 ## Phase A — Prepare spec
 
-### Option 1: Scripted (worktrees) — from a Notion page
+### Option 1: Scripted (worktrees)
 
 From the repo root, run:
 
 ```bash
-scripts/agent/prepare-spec.sh <slug> <notion-link>
+scripts/agent/prepare-spec.sh <slug> <source>
 ```
 
+The `<source>` can be:
+
+| Source | Example |
+|--------|---------|
+| Notion page URL | `https://www.notion.so/org/Page-Title-abc123` |
+| Google Drive doc URL | `https://docs.google.com/document/d/...` |
+| Local file path | `.agent-workflow/briefs/my-feature.md` |
+
+The script auto-detects the source type — no extra flags needed.
+
 This script:
 - creates a worktree at `~/agent-runs/{PROJECT_NAME}/worktrees/spec-<slug>` on branch `agent/spec/<slug>`
 - starts a Claude session inside that worktree
-- invokes `/prepare-spec` with the given Notion link
+- invokes `/prepare-spec` with the detected source
 
-The agent fetches the Notion page, maps content to the spec template, asks clarifying questions, then writes `.agent-workflow/specs/<date>_<slug>.md` with `status: draft`.
+The agent fetches the source, maps content to the spec template, asks clarifying questions, then writes `.agent-workflow/specs/<date>_<slug>.md` with `status: draft`.
 
 Add `--interactive` to follow along in the same session and skip the automatic GitLab MR:
 
 ```bash
-scripts/agent/prepare-spec.sh --interactive \<slug\> \<notion-link\>
+scripts/agent/prepare-spec.sh --interactive <slug> <source>
 ```
 
 Claude launches interactively with the first message pre-filled. The worktree and branch are still created — but nothing is pushed or opened in GitLab unless you do it manually.
 
-### Option 2: Direct (no worktrees) — from a Notion page or description
+### Option 2: Direct (no worktrees)
 
 Skip the script and run everything yourself:
 
@@ -93,10 +103,13 @@ git checkout -b agent/spec/<slug>
 # 2. Open Claude in the repo root
 claude
 
-# 3. Inside Claude, invoke the skill
-/prepare-spec <notion-link>
-# or for a free-form description:
-# "Use prepare-spec skill, here is the feature: ..."
+# 3. Inside Claude, invoke the skill — <source> can be a Notion URL, GDrive URL, or local file path
+/prepare-spec <source>
+# examples:
+# /prepare-spec https://www.notion.so/org/Page-abc123
+# /prepare-spec https://docs.google.com/document/d/...
+# /prepare-spec .agent-workflow/briefs/my-feature.md
+# or free-form: "Use prepare-spec skill, here is the feature: ..."
 ```
 
 The agent will write the spec, commit it, and open a GitLab MR on the current branch — no worktree needed.

package/templates/agents-workflow-env-setup.md

@@ -79,10 +79,11 @@ Claude Code will read `CLAUDE.md` and `.claude/rules/agentic-workflow.md` automa
 
 **Scripted (auto worktree + branch):**
 ```bash
-scripts/agent/prepare-spec.sh <spec-name> <notion-link>
+# <source> = Notion URL, Google Drive URL, or local file path (auto-detected)
+scripts/agent/prepare-spec.sh <spec-name> <source>
 
 # Add --interactive to follow along and skip automatic GitLab MR:
-scripts/agent/prepare-spec.sh --interactive <spec-name> <notion-link>
+scripts/agent/prepare-spec.sh --interactive <spec-name> <source>
 ```
 
 **Direct (manual branch, no worktree):**

package/templates/scripts/agent/prepare-spec.sh

@@ -14,14 +14,23 @@ done
 set -- "${POSITIONAL[@]}"
 
 if [[ $# -lt 2 ]]; then
-  echo "Usage: $0 [--interactive] <slug> <notion_url>" >&2
+  echo "Usage: $0 [--interactive] <slug> <notion-url|gdrive-url|local-file>" >&2
   exit 1
 fi
 
 SLUG="$1"
-NOTION_URL="$2"
+SOURCE="$2"
 REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
 
+# Detect source type and build prompt
+if [[ "$SOURCE" == *"notion.so"* ]]; then
+  SOURCE_PROMPT="use prepare-spec skill from Notion page: ${SOURCE}"
+elif [[ "$SOURCE" == *"docs.google.com"* || "$SOURCE" == *"drive.google.com"* ]]; then
+  SOURCE_PROMPT="use prepare-spec skill from Google Drive document: ${SOURCE}"
+else
+  SOURCE_PROMPT="use prepare-spec skill from local file: ${SOURCE}"
+fi
+
 echo "Preparing spec worktree for '${SLUG}'..." >&2
 OUTPUT=$(bash "${REPO_ROOT}/scripts/agent/git-prepare-worktree.sh" spec "${SLUG}" "${REPO_ROOT}")
 WORKTREE_DIR=$(echo "${OUTPUT}" | grep '^WORKTREE_DIR=' | cut -d= -f2-)
@@ -31,7 +40,7 @@ cd "${WORKTREE_DIR}"
 
 if [[ "$INTERACTIVE" == true ]]; then
   echo "Starting interactive Claude session (GitLab flow disabled)..." >&2
-  exec claude --dangerously-skip-permissions "use prepare-spec skill from ${NOTION_URL}. Skip GitLab flow — do not push or open an MR."
+  exec claude --dangerously-skip-permissions "${SOURCE_PROMPT}. Skip GitLab flow — do not push or open an MR."
 else
-  exec claude --dangerously-skip-permissions -p "use prepare-spec skill from ${NOTION_URL}"
+  exec claude --dangerously-skip-permissions -p "${SOURCE_PROMPT}"
 fi