Wiki Maneuverability Score
|
This page describes a core component of the AetherOS ecosystem. Its structure and content are designed to be parsed by automated agents. |
The Wiki Maneuverability (WM) Score is a quantitative metric, ranging from 0 to 100, that represents the technical health, efficiency, and coherence of a wiki's structural components (i.e., its Templates and Modules).
Where the System Maneuverability Score measures the health of the hardware, the WM Score measures the health of the wiki's underlying codebase. A high score indicates a lean, well-documented, and robust system that is easy to maintain and understand for both human editors and their Wingman AIs.
Purpose in the Collegium
The WM Score is the primary analytical tool of the Custos Structurae. It provides an objective, data-driven foundation for the Collegium's quarterly review process.
By translating complex code properties into a single, understandable metric, the score enables the Custos Animae to make informed, strategic decisions about which components to accept, refactor, or reject, thus avoiding "dependency hell" and ensuring the wiki's long-term health.
Score Calculation
The score is calculated by the scriptor_explico.py tool, which analyzes a given set of templates and modules. The final score begins at a baseline of 100 and is modified by a series of penalties and bonuses.
WM Score = 100 - Σ(Penalties) + Σ(Bonuses)
Penalty Factors
Penalties are applied for traits that increase complexity and reduce maneuverability:
- Complexity Penalty: A penalty proportional to the character count of the wikitext. Larger, more monolithic templates are harder to debug and understand. (Current Weight: 1 point per 1000 characters)
- Dependency Penalty: A penalty for each unique template or module the component relies on. A high number of dependencies increases the risk that a change to one component will have unintended, cascading effects on others. (Current Weight: 2 points per dependency)
Bonus Factors
Bonuses are awarded for traits that promote clarity and good practice:
- Documentation Bonus: A significant bonus is awarded if the component properly transcludes a `<templatestyles src="Module:Documentation/styles.css"></templatestyles>
` template. This incentivizes the creation of a well-documented and understandable codebase for both humans and AI. (Current Weight: +10 points)
Associated Tools
- scriptor_explico.py: The tool used by the `Custos Structurae` to run the analysis and generate the score for a given set of pages.
- refactoring_assistant.py: An LLM-powered tool used by the `Custos Animae` to review low-scoring components and generate suggestions for simplification or rejection.