ChangeCore Specification

Home / ChangeCore / ChangeCore Specification

ChangeCore

Rank through relevance, not repetition.

Specification

ChangeCore is an open source content intelligence and evolution system designed to continuously monitor, analyze, and improve web content. The system treats pages as living content that must evolve as facts change, user intent shifts, new information becomes available, and search and AI discovery systems change.

ChangeCore is designed to identify meaningful opportunities for improvement rather than relying on superficial content changes. It combines freshness intelligence, relevance analysis, knowledge modeling, AI search visibility, external data ingestion, multi-agent analysis, automated content evolution, and human oversight into a unified system.

Core Modules

Content Monitoring Module

The Content Monitoring Module continuously evaluates pages and their underlying content for changes, deterioration, and opportunities for improvement.

Continuous monitoring of pages and content
Full-page semantic comparison
Detection of structural, factual, and contextual changes
Semantic diffing that evaluates meaning and intent
Page freshness measurement
Content lifecycle tracking
Version history and content state tracking
Section-level monitoring
Detection of content decay
Identification of pages requiring review

Freshness Intelligence Module

The Freshness Intelligence Module determines whether information remains current and identifies content that may have become outdated.

Detection of outdated facts
Detection of outdated statistics
Detection of stale claims
Detection of outdated references
Detection of obsolete documentation
Detection of outdated examples
Detection of outdated screenshots and media
Detection of deprecated external resources
Content decay measurement
Section-level freshness analysis
Topic-level freshness analysis
Freshness recommendations based on observed change

Relevance Intelligence Module

The Relevance Intelligence Module evaluates whether content continues to satisfy current information needs.

Topical relevance analysis
Search intent analysis
User intent evolution tracking
Emerging topic detection
Emerging query detection
Missing subtopic detection
Content coverage analysis
Relevance density analysis
Repetition detection
Over-optimization detection
Topic cluster analysis
Identification of content that no longer matches its intended purpose

AI Search Visibility Module

The AI Search Visibility Module evaluates and improves how content can be discovered, interpreted, retrieved, and cited by AI-driven search and answer systems.

AI citation tracking
AI mention tracking
AI visibility measurement
Page-level AI visibility analysis
Section-level AI visibility analysis
AI retrieval analysis
Prompt-based content evaluation
AI answer inclusion analysis
Direct answer block recommendations
Semantic snippet optimization
Entity coverage analysis
Content structure analysis for AI retrieval
Generative Engine Optimization analysis
AI visibility feedback loops
Comparison of content representation across AI discovery surfaces

AI Content Gap Module

The AI Content Gap Module identifies information that users may need but that existing pages do not adequately address.

Unanswered question detection
Missing FAQ detection
Missing contextual information detection
Missing entity detection
Missing topic detection
Query cluster analysis
Emerging intent analysis
Content blind spot detection
Suggested section generation
Suggested comparison generation
Suggested examples
Suggested explanatory content
Content expansion recommendations based on relevance rather than keyword density

Multi-Agent Architecture Module

The Multi-Agent Architecture Module coordinates specialized agents that independently evaluate different aspects of content.

The system may include specialized agents such as:

Fact Agent for factual validation and factual drift detection
SEO Agent for search relevance and optimization analysis
Intent Agent for evolving user intent
Structure Agent for hierarchy, readability, and structured content
Link Agent for internal and external link relationships
Trend Agent for emerging external signals
AI Visibility Agent for AI retrieval and citation visibility
Risk Agent for low-quality, repetitive, misleading, or over-optimized changes

The coordination system provides:

Agent orchestration
Agent communication
Recommendation aggregation
Recommendation prioritization
Conflict detection
Conflict resolution
Consensus-based recommendations
Priority-based execution
Agent-specific confidence measurements
Human approval controls
Agent decision explanations
Agent activity history
Extensible agent registration

Data Ingestion Module

The Data Ingestion Module continuously collects external information that may affect the accuracy, relevance, or freshness of website content.

Supported source categories include:

RSS feeds
Atom feeds
Web feeds
API data sources
Software release information
Changelogs
Documentation updates
Academic publications
Government publications
Regulatory information
Industry publications
News sources
Knowledge databases
Product information
Pricing information
Custom data sources
Webhook events

The ingestion system provides:

Source registration
Source monitoring
Source reliability assessment
Source change detection
Change frequency profiling
Data normalization
Data deduplication
Contradiction identification
Temporal indexing
Event classification
Source provenance tracking
Ingestion history
Configurable ingestion schedules
Real-time event processing

Knowledge Graph Module

The Knowledge Graph Module maintains a continuously evolving semantic representation of the content ecosystem.

Entity identification
Entity relationships
Topic relationships
Concept relationships
Page-to-entity relationships
Entity-to-source relationships
Topic clustering
Semantic relationship mapping
Knowledge graph updates
Missing relationship detection
Missing entity detection
Content cluster analysis
Internal linking opportunities
Historical relationship tracking

Fact Integrity Module

The Fact Integrity Module evaluates factual claims and monitors them as external information changes.

Claim extraction
Claim tracking
Source association
Source provenance
Multiple-source comparison
Contradiction detection
Fact drift detection
Confidence measurement
Claim freshness measurement
Cross-page fact consistency
Outdated claim identification
Fact verification recommendations
Historical claim tracking

Citation Intelligence Module

The Citation Intelligence Module maintains the quality and relevance of citations and references.

Citation discovery
Citation validation
Broken citation detection
Dead source detection
Source freshness analysis
Citation relevance analysis
Citation provenance
Replacement source recommendations
Authoritative source identification
Cross-page citation consistency
Citation history tracking

Link Intelligence Module

The Link Intelligence Module evaluates relationships between pages and identifies opportunities to improve site connectivity.

Broken link detection
Internal link analysis
External link analysis
Orphan page detection
Weakly connected page detection
Contextual link recommendations
Anchor text recommendations
Topic-based linking
Entity-based linking
Link relationship mapping
Link history tracking
Link change monitoring

Content Evolution Module

The Content Evolution Module transforms approved recommendations into targeted content improvements.

Targeted content updates
Section generation
Section expansion
Section reduction
Example generation
Comparison generation
FAQ generation
Summary regeneration
Citation replacement
Outdated information replacement
Contextual content improvements
Content restructuring
Content consolidation
Duplicate content reduction
Relevance-driven rewriting
Controlled content regeneration

Metadata and Structured Content Module

The Metadata and Structured Content Module keeps page metadata and structured information synchronized with evolving content.

Title analysis
Description analysis
Metadata freshness
Metadata-content consistency
Open Graph information
Social preview information
Structured data generation
Structured data validation
FAQ structured data
HowTo structured data
Article structured data
Dataset structured data
Software-related structured data
Event-related structured data
Entity structured data
AI-readable content structures

Event-Driven Refresh Module

The Event-Driven Refresh Module triggers content analysis when relevant external events occur.

Software release triggers
API change triggers
Documentation change triggers
Regulatory change triggers
Research publication triggers
Pricing change triggers
Industry event triggers
Seasonal triggers
Trend triggers
Custom webhook triggers
Source-specific triggers
Entity change triggers
Topic change triggers
Configurable event thresholds

Scheduling and Adaptation Module

The Scheduling and Adaptation Module determines when content should be monitored or reviewed.

Page-specific refresh schedules
Section-specific refresh schedules
Topic-specific schedules
Adaptive monitoring intervals
Content decay-based scheduling
Change frequency-based scheduling
Priority-based scheduling
Event-based scheduling
High-priority content monitoring
Low-priority content monitoring
Scheduling recommendations
Automatic cadence adjustment

Human-in-the-Loop Module

The Human-in-the-Loop Module ensures that users maintain control over consequential content changes.

Review queues
Change previews
Accept actions
Reject actions
Edit actions
Approval workflows
Manual overrides
Confidence indicators
Recommendation explanations
Source visibility
Agent attribution
Change history
Decision history
Human approval requirements by content type
Configurable automation limits

Risk and Quality Module

The Risk and Quality Module evaluates proposed changes before they are applied.

Repetition detection
Keyword stuffing detection
Over-optimization detection
Low-quality change detection
Unsupported claim detection
Conflicting information detection
Hallucination risk detection
Source quality evaluation
Content coherence analysis
Readability analysis
Content integrity checks
Change impact analysis
Configurable risk thresholds
Human escalation for high-risk changes

Analytics and Observability Module

The Analytics and Observability Module provides visibility into content evolution and system activity.

Freshness history
Relevance history
Content decay history
AI visibility history
Citation history
Link health history
Update history
Recommendation history
Agent activity
Data ingestion activity
Change acceptance rates
Change rejection rates
Content recovery measurements
Topic-level analytics
Site-level analytics
Content evolution dashboards

API Module

The API Module provides programmatic access to ChangeCore capabilities.

Page scanning
Content analysis
Freshness analysis
Relevance analysis
AI visibility analysis
Recommendation retrieval
Recommendation approval
Recommendation rejection
Content update requests
History retrieval
Knowledge graph access
Agent status
Ingestion status
Event submission
Webhook management
Bulk operations
Authentication and authorization controls

MCP and AI Agent Module

The MCP and AI Agent Module allows compatible AI agents to interact with ChangeCore.

Machine-readable content state
AI-assisted page inspection
AI-assisted content analysis
AI-assisted content updates
Freshness auditing
Fact verification workflows
Content gap analysis
Relevance analysis
Knowledge graph queries
Agent-assisted recommendations
Multi-agent workflows
Human approval integration
Controlled agent actions
Action history and provenance

Content Lifecycle Module

The Content Lifecycle Module tracks content from creation through continued evolution.

Content creation state
Active content state
Aging state
Drift state
Decay state
Review state
Update state
Regeneration state
Archived state
Section-level lifecycle tracking
Lifecycle transition history
Lifecycle-based automation

Provenance and Audit Module

The Provenance and Audit Module records where information and changes originate.

Source provenance
Claim provenance
Recommendation provenance
Agent provenance
Human decision provenance
Content change provenance
Data ingestion provenance
Version history
Timestamped change records
Source-to-content relationships
Content-to-recommendation relationships
Recommendation-to-change relationships
Complete audit history

Optional Plugin Modules

ChangeCore supports optional plugins that extend the core system without requiring every installation to use every capability.

CMS Integration Plugins

Optional integrations may support:

WordPress
Drupal
Ghost
Other content management systems
Headless content systems
Custom publishing systems

CMS plugins may provide:

Page discovery
Content synchronization
Metadata synchronization
Draft creation
Content update workflows
Publishing controls
Change status synchronization

Static Site Plugins

Optional integrations may support:

Static website content
Documentation websites
Generated websites
Markdown-based content systems
Custom publishing pipelines

Static site plugins may provide:

Content discovery
Content analysis
Change generation
Build triggers
Publishing workflows
Version synchronization

Search Intelligence Plugins

Optional plugins may provide integrations for external search data and search analysis.

Search query data
Search result monitoring
Search visibility tracking
Search trend analysis
Search intent signals
Search performance history

AI Provider Plugins

Optional plugins may connect ChangeCore to external AI systems.

Content analysis
Semantic analysis
Content generation
Embedding generation
AI visibility testing
Prompt testing
Model-specific analysis
Provider-specific capabilities

Provider abstraction should allow users to select supported AI services or operate compatible local or self-hosted models where available.

Knowledge Source Plugins

Optional plugins may connect additional external knowledge sources.

Government databases
Academic databases
Industry databases
Public datasets
Knowledge graphs
Documentation repositories
Specialized information services

Analytics Plugins

Optional plugins may connect external analytics and measurement services.

Search performance data
Traffic data
Engagement measurements
Conversion measurements
AI visibility measurements
Custom performance signals

Notification Plugins

Optional plugins may provide alerts through supported communication systems.

Email notifications
Web notifications
Messaging notifications
Change alerts
Fact drift alerts
Critical freshness alerts
Approval notifications
System health notifications

Automation Plugins

Optional plugins may extend event-driven workflows.

Custom triggers
Custom actions
Scheduled workflows
Conditional workflows
External automation events
Approval workflows
Publishing workflows

Agent Plugins

Optional plugins may introduce specialized agents beyond the core agent set.

Custom research agents
Industry-specific agents
Organization-specific agents
Domain-specific fact agents
Custom compliance agents
Custom editorial agents
Custom quality agents

Plugin System Requirements

Optional plugins should:

Operate independently from unrelated modules
Clearly define their capabilities
Define their required inputs
Define their outputs
Identify external dependencies
Respect ChangeCore permissions
Preserve provenance
Record plugin-generated changes
Support human approval controls where applicable
Avoid bypassing audit mechanisms
Remain compatible with the project’s licensing requirements

Specification Branding License (SBL)

Standard

Fully AGPL-3.0+ compliant system
Copyleft enforced for network deployments
Required attribution:
- Roxanne Ardary
- https://www.roxanneardary.com/

Optional

Specification Branding License (SBL)
Attribution-free commercial deployment
Pricing based on scale, usage, and deployment scope
https://roxanneardary.com/changecore/

License & Notice Requirements

ChangeCore is released under the GNU Affero General Public License v3.0 or later (AGPL-3.0+).
By contributing to this project, you agree that your contributions will also be released under this license.

Please note the following:

All contributions must comply with the AGPL-3.0+ terms.
Under Section 7 of the license, all redistributions, forks, and derivative works must preserve attribution to:
Roxanne Ardary and roxanneardary.com.
ChangeCore specifications are free to use with attribution. A Specification Branding License can be negotiated upon request.
The project’s notice.md file tracks attribution requirements and contributor acknowledgments.
Any update that adds new contributors or modifies attribution should also update notice.md.
When submitting a pull request, ensure that any new files maintain the attribution headers where applicable.
Network-deployed versions of this software must also remain fully AGPL-3.0+ compliant, including exposure of source code modifications when applicable under the license.

For full legal details, please refer to the AGPL-3.0+ license and the project’s notice.md file.

Notice – ChangeCore

Attribution Requirement: Under Section 7 of the AGPL 3.0+ license, all redistributions, forks, and derivative works, including network-deployed versions of this project, must provide attribution to Roxanne Ardary and roxanneardary.com.

Contributors

This file tracks contributors and their specific contributions to the project.

Roxanne Ardary, roxanneardary.com – June 6, 2026
Created the ChangeCore repository and defined the initial system architecture for a multi-agent content intelligence platform focused on continuous freshness, relevance ranking, and AI search visibility optimization.
[Add other contributors here] – [Date]
[Describe contribution in one sentence]

License – ChangeCore

This repository is licensed under the GNU Affero General Public License v3.0 or later (AGPL-3.0+).

Key Points

You are free to use, modify, and distribute the code.
All redistributions, forks, and derivative works or network-deployed versions must also be licensed under AGPL-3.0+ and provide attribution to Roxanne Ardary and roxanneardary.com as required under Section 7 of the license.
The software is provided “as is,” without warranty of any kind.

For the full license text, see GNU AGPL-3.0 License.