Skip to content

feat: V4.0 — portable evidence-based competitive intelligence agent - #2

Open
diandian1001 wants to merge 4 commits into
mainfrom
improve/v3.1-polish
Open

feat: V4.0 — portable evidence-based competitive intelligence agent#2
diandian1001 wants to merge 4 commits into
mainfrom
improve/v3.1-polish

Conversation

@diandian1001

@diandian1001 diandian1001 commented Jul 15, 2026

Copy link
Copy Markdown
Owner

Summary

Upgrades the repository from a competitive-analysis workflow into a portable, executable and traceable AI Competitive Intelligence Operating System.

V4.0 Goals

  • Let users provide the repository, Skill or one portable file to an AI/Agent
  • Start professional competitive analysis with minimal setup
  • Establish the user's own-product baseline before judging competitors
  • Select competitors using decision-specific weights
  • Track important claims through a Claim-level evidence ledger
  • Separate action type from priority
  • Produce different outputs for quick, standard and deep analysis
  • Validate the final output before declaring completion

New Files

  • AGENTS.md
  • PORTABLE.md
  • templates/project-state.md
  • templates/evidence-ledger.md
  • templates/output-quick.md
  • templates/output-standard.md
  • templates/output-deep.md

Core Changes

  • Adds own-product baseline as a required phase
  • Makes candidate-pool size dynamic by execution mode and information gain
  • Replaces fixed equal-weight /14 selection with decision-specific weighting
  • Adds Claim IDs, source time, direct-support text, evidence grade, conflicts and limitations
  • Separates BUILD / VALIDATE / MONITOR / REJECT from P0 / P1 / P2 / P3
  • Adds quick, standard and deep output templates
  • Prevents empty Pattern sections from being mechanically filled
  • Adds project-state tracking and a portable single-file version
  • Adds cross-routing to the AI User Research Operating System
  • Strengthens Benchmark methodology with repeated runs and source verification

Validation

  • Internal Markdown links checked
  • Required V4.0 files verified
  • Portable file checked for embedded Skill and templates
  • Fixed /14 scoring removed from current rules
  • No temporary files committed

Merge

Do not merge until the V4.0 content and validation results have been independently reviewed.

…nhanced evidence rules

### New files
- evaluation/benchmark.md: 3 test tasks with 7-dimension scoring rubric (status: design complete, pending execution)
- templates/output-template.md: unified 10-section result template integrating all existing templates

### README.md + README_zh.md (fully synced)
- Add 30-second input→output example with sanitized business problem
- Add 'When to Use / Not Suitable' section with 7 failure scenarios
- Add V3.0 Key Changes comparison table to English README (was only in Chinese)
- Expand repository structure to show all files
- Add platform-specific usage options (ChatGPT/Claude/Hermes)
- Sync scope section between English and Chinese versions

### references/evidence-rubric.md (enhanced)
- Add capability boundaries: what each grade (A/B/C/D) can support
- Add critical principle: conclusion certainty ≤ evidence certainty
- Add source conflict resolution rules (time priority, authority, alignment, irreconcilable)
- Add stale information handling table (6 info types with validity periods and downgrade rules)
- Add 2 new prohibited practices (D-grade masking, forced precision)
…ading rules

### README.md + README_zh.md
- Remove unverified percentages (40% return visits, 7/12/5/3 evidence counts)
- Remove fabricated competitor count (4 from 10)
- Replace with structural placeholders and 'structure illustrative' warning
- Add ⚠️ disclaimer: examples are structural illustrations, not real conclusions

### evidence-rubric.md
- Add 5-dimension evaluation framework (source, claim-match, sample, timeliness, cross-validation)
- Each grade now requires all 5 dimensions, not just source name
- Add critical examples: official page = A for 'feature exists', D for 'feature effective'
- Add: product testing can prove path, not preference; data can prove correlation, not causation
- Time windows changed from fixed rules to advisory defaults
- Add industry-specific and risk-adjusted guidance
### evidence-rubric.md
- Fix A-grade: no longer mechanically requires sample+validation for ALL claims
- Add principle: different claims have different evidence requirements
- Add examples: official page = A for feature existence, NOT A for business effect
- B-grade updated for consistency

### README.md
- Replace Chinese disclaimer with English
- Add English equivalents alongside Chinese labels (事实/Fact, 推断/Inference, 待验证/Unverified)
@diandian1001 diandian1001 changed the title feat: V3.1 polish — I/O example, benchmark, output template, scope, enhanced evidence rules feat: V4.0 — portable evidence-based competitive intelligence agent Jul 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant