@nahisaho/shikigami 1.40.0 → 1.42.0

package/AGENTS.md

@@ -18,6 +18,11 @@
    - Do NOT read files, search, or analyze before project setup
    - Do NOT skip to "investigating" the topic
 
+3. After Phase 0, you MUST execute Phase 1 (Prompt Optimization):
+   - Display 6-element structured prompt
+   - WAIT for user approval
+   - Do NOT start search until user approves
+
 VIOLATION = WORKFLOW FAILURE
 ```
 
@@ -27,7 +32,7 @@ VIOLATION = WORKFLOW FAILURE
 
 | Item | Value |
 |------|-------|
-| Version | 1.40.0 |
+| Version | 1.42.0 |
 | Agent Skills | 4 |
 | MCP Tools | 11 |
 | Frameworks | 53 |
@@ -141,14 +146,53 @@ FORBIDDEN: Web search, using search tools, or gathering information before proje
 
 ### Prohibition 3: save_research Required After search/visit
 
+**🚨🚨🚨 EVERY search/visit MUST be followed by save_research 🚨🚨🚨**
+
 ```
 WHEN: Executed search or visit MCP tool
-DO: IMMEDIATELY call save_research MCP tool (within the same response)
-EXAMPLE:
-  1. search(query: "AI market trends")
-  2. save_research(content: <search results>, source: "search", query: "AI market trends")
-FORBIDDEN: Proceeding to next process without saving
-CONSEQUENCE: Research data will be lost if not saved
+DO: IMMEDIATELY call save_research MCP tool (within the SAME response, not later)
+
+MANDATORY PATTERN - NO EXCEPTIONS:
+  search(...) → save_research(...) → next action
+  visit(...)  → save_research(...) → next action
+
+EXAMPLE 1 (Search):
+  1. search(query: ["AI市場動向", "AI market trends"])
+  2. save_research(
+       content: "<検索結果の全文をここに>",
+       source: "search",
+       query: "AI市場動向"
+     )
+
+EXAMPLE 2 (Visit):
+  1. visit(url: "https://example.com/article")
+  2. save_research(
+       content: "<ページ内容の全文をここに>",
+       source: "visit",
+       query: "https://example.com/article"
+     )
+
+FORBIDDEN (IMMEDIATE VIOLATION):
+  - Calling search then another search without save_research in between
+  - Calling visit then summarizing without save_research first
+  - Proceeding to analysis without saving raw data
+  - "I'll save it later" - NO! Save IMMEDIATELY
+
+CONSEQUENCE: Research data will be lost, workflow corrupted, unable to cite sources
+```
+
+**CORRECT FLOW**:
+```
+Agent: search(query: [...])
+       → [結果を受信]
+       → save_research(content: <全結果>, source: "search", query: <query>)
+       → "検索結果を保存しました。次に..."
+```
+
+**INCORRECT FLOW (VIOLATION)**:
+```
+Agent: search(query: [...])
+       → "検索結果によると..." ← ❌ save_research を呼んでいない！
 ```
 
 ### Prohibition 4: save_prompt Required After User Input
@@ -312,13 +356,16 @@ DO:
     3. After user confirms name: Execute npx shikigami new <ProjectName>
     4. Execute set_project(autoDetect: true)
     5. Save original prompt with save_prompt(type: "original")
+    6. IMMEDIATELY proceed to Phase 1 (Prompt Optimization) - DO NOT START SEARCH
 OUTPUT: projects/pjXXXXX_ProjectName_YYYYMMDD/
+NEXT: Phase 1 (Prompt Optimization) - NOT Phase 3 (Search)
 ```
 
 **CRITICAL**: 
-- If user indicates project is already created → skip to set_project and proceed
+- If user indicates project is already created → skip to set_project and proceed to Phase 1
 - If new request → MUST ask user for project name confirmation
 - You MUST NOT skip to research phase without project activation
+- After Phase 0, you MUST execute Phase 1 (NOT jump to search)
 
 **Naming Rules**:
 - Folder: `pjXXXXX_ProjectName_YYYYMMDD`
@@ -327,24 +374,56 @@ OUTPUT: projects/pjXXXXX_ProjectName_YYYYMMDD/
 
 ### Phase 1: Prompt Optimization
 
-**THIS PHASE IS MANDATORY - DO NOT SKIP**
+** THIS PHASE IS MANDATORY - NEVER SKIP **
 
 ```
-WHEN: Phase 0 completed
+WHEN: Phase 0 completed (project created and set_project called)
 DO:
-  1. Analyze original prompt and structure into 6 elements (see table below)
-  2. Display structured prompt to user in formatted table
-  3. Save with save_prompt(type: "structured")
-  4. Ask user: "Please review and approve this structured prompt, or suggest modifications."
-  5. WAIT for user approval (do NOT proceed without approval)
-  6. Save approval/modifications with save_prompt(type: "approval" or "instruction")
+  1. STOP - Do NOT start searching yet
+  2. Analyze original prompt and structure into 6 elements (see table below)
+  3. Display structured prompt to user in formatted table
+  4. Save with save_prompt(type: "structured")
+  5. Ask user: "Please review and approve this structured prompt, or suggest modifications."
+  6. WAIT for user approval (do NOT proceed without approval)
+  7. Save approval/modifications with save_prompt(type: "approval" or "instruction")
 OUTPUT: 6-element structured prompt (user approved)
+
+FORBIDDEN (IMMEDIATE VIOLATION):
+  - Starting search/visit before user approves structured prompt
+  - Skipping directly to Phase 2 or Phase 3
+  - Proceeding without displaying the 6-element table
+  - Assuming user approval without explicit confirmation
 ```
 
 **CRITICAL**:
 - You MUST display the 6-element structured prompt
 - You MUST wait for user approval before proceeding to Phase 2
 - You MUST NOT skip prompt optimization
+- You MUST NOT start web search until Phase 3
+
+**CORRECT FLOW AFTER PROJECT CREATION**:
+```
+Agent: "プロジェクトを作成しました。次にプロンプトを構造化します。
+
+| 要素 | 内容 |
+|------|------|
+| PURPOSE | ... |
+| TARGET | ... |
+| SCOPE | ... |
+| TIMELINE | ... |
+| CONSTRAINTS | ... |
+| DELIVERABLES | ... |
+
+この構造化プロンプトを確認して承認してください。修正があればお知らせください。"
+
+→ WAIT for user response ←
+```
+
+**INCORRECT FLOW (VIOLATION)**:
+```
+Agent: "プロジェクトを作成しました。では調査を開始します..." ← ❌ WRONG!
+Agent: "検索します..." ← ❌ WRONG! Phase 1 skipped!
+```
 
 **6 Elements**:
 | Element | Description |
@@ -383,15 +462,34 @@ DO:
   LOOP:
     1. Think: Analyze knowledge gaps
     2. Search: search(query: ["Japanese query", "English query"])
-    3. IMMEDIATELY: save_research(content: <search_results>, source: "search", query: <query>)
+    3. 🚨 IMMEDIATELY: save_research(content: <FULL search_results>, source: "search", query: <query>)
+       → Do NOT proceed without this step!
     4. Visit: visit(url: <target_url>)
-    5. IMMEDIATELY: save_research(content: <page_content>, source: "visit", query: <url>)
+    5. 🚨 IMMEDIATELY: save_research(content: <FULL page_content>, source: "visit", query: <url>)
+       → Do NOT proceed without this step!
     6. Report: Organize collected information
     7. Action: Determine if additional search needed
 OUTPUT: Collected information summary, source list (URL + credibility)
 ```
 
-**CRITICAL**: Steps 3 and 5 are MANDATORY. Never skip save_research calls.
+**🚨 CRITICAL - save_research is MANDATORY after EVERY search/visit**:
+- Steps 3 and 5 are NOT optional
+- You MUST call save_research IMMEDIATELY after each search/visit
+- Do NOT analyze or summarize before saving raw data
+- Do NOT call multiple searches without saving each one
+
+**CORRECT Phase 3 Flow**:
+```
+search(query: [...])
+↓
+save_research(content: <全結果>, source: "search", ...)  ← 必須！
+↓
+visit(url: ...)
+↓
+save_research(content: <全内容>, source: "visit", ...)   ← 必須！
+↓
+[分析・次のアクション]
+```
 
 **Search Rules**:
 - Parallel JP/EN search required: `["Japanese query", "English query"]`
@@ -675,4 +773,4 @@ DO: Auto-detect Shift_JIS/EUC-JP/ISO-2022-JP and convert to UTF-8
 ---
 
 **Last Updated**: 2026-01-28  
-**Version**: 1.40.0
+**Version**: 1.42.0

package/CHANGELOG.md

@@ -5,6 +5,41 @@ All notable changes to SHIKIGAMI will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.42.0] - 2026-01-28
+
+### Added
+
+- **AGENTS.md: Enforce save_research after every search/visit**
+  - Prohibition 3: Added 🚨🚨🚨 warning header
+  - Added MANDATORY PATTERN section with clear flow
+  - Added detailed EXAMPLE 1 (Search) and EXAMPLE 2 (Visit) with full parameters
+  - Added CORRECT/INCORRECT flow examples
+  - Added explicit prohibition against "I'll save it later"
+
+- **AGENTS.md: Phase 3 save_research enforcement**
+  - Added 🚨 markers to steps 3 and 5
+  - Added "Do NOT proceed without this step!" warnings
+  - Added CORRECT Phase 3 Flow diagram
+  - Expanded CRITICAL section with specific prohibitions
+
+## [1.41.0] - 2026-01-28
+
+### Added
+
+- **AGENTS.md: Enforce Phase 1 (Prompt Optimization) execution**
+  - Added Phase 1 requirement to ABSOLUTE FIRST RULE section
+  - Added CORRECT/INCORRECT flow examples for Phase 1
+  - Added FORBIDDEN list for Phase 1 violations
+  - Phase 0 output now explicitly states "NEXT: Phase 1"
+
+### Changed
+
+- **AGENTS.md: Stronger Phase 1 enforcement**
+  - Phase 1 header: "🚨🚨🚨 THIS PHASE IS MANDATORY - NEVER SKIP 🚨🚨🚨"
+  - Added step "STOP - Do NOT start searching yet" as first action
+  - Explicit prohibition against starting search before user approval
+  - Phase 0 CRITICAL section now includes "After Phase 0, you MUST execute Phase 1"
+
 ## [1.40.0] - 2026-01-28
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nahisaho/shikigami",
-  "version": "1.40.0",
+  "version": "1.42.0",
   "description": "GitHub Copilot Agent Skills for Deep Research & Consulting - AI-Powered Research Assistant with 50+ Consulting Frameworks",
   "keywords": [
     "github-copilot",