{"schema":"https://ver.cy/schemas/card/1.0.0","id":"vr.wm-knw-004","code":"wm-knw-004-knowledge-article","url":"https://ver.cy/models/wm-knw-004-knowledge-article/","name":"Knowledge Article","alternateNames":[],"kind":"world-model","status":"published","version":"0.1.0","language":"en","classifiers":{"family":"World Models","category":"Information and virtual systems","entryKind":"entity","plane":"","domain":["INF.KNW.ART"],"industry":["Cross-industry"],"navPath":"NAV.INF.KNW.ART","tags":["knowledge","article","inf.knw.art"],"facets":{}},"whatItIs":"A knowledge article is a curated, versioned piece of explanatory content that answers a defined question or describes how to resolve a known issue, kept in a knowledge base with an owner, an audience and a review cycle. It is narrower than a document in general and differs from a scholarly publication, a formal standard or a single concept definition.","purpose":"Curated, versioned articles that answer a defined question or resolve a known issue.","scope":{"in":["Article identity, issue context, applicability and proposed answer","Revision and translation lineage, attribution, review evidence and independent visibility assertions","Article-specific correction, reuse, retirement and projection records"],"out":["Knowledge-base administration, search engine or retrieval pipeline implementation","Case, product, person, policy and document repository master lifecycles","Executable agent skills, operational procedures, permission enforcement and claims of regulatory compliance","Detailed instructions for weapons, detention or controlled items; only applicable policy and escalation references are allowed"],"boundaries":[{"neighbor":"WM-REC-001 Document / Record","distinction":"Candidate reference for separately mastered evidence and renditions; this model owns article semantics, not general records management or storage operations."},{"neighbor":"WM-ACT-021 Service Case / Ticket","distinction":"Candidate reference to a motivating or reuse case. Case identity and resolution outcome remain in the case master; linking an article does not prove it resolved a case."},{"neighbor":"WM-KNW-005 Agent Skill / Instruction","distinction":"Candidate reference to an executable instruction contract. A person or agent can consume an article; consumption does not turn prose into execution authority."},{"neighbor":"Policy, standard and concept masters","distinction":"The article may explain or reference these resources; it neither enacts their authority nor replaces their authoritative definitions."}]},"distinguishingFeatures":["Answers a defined question or issue for a stated audience, unlike a general document or record.","Curated and reviewed on a cycle, unlike a forum post or chat message.","Explains and instructs; a formal norm belongs to the policy or standard models and a term to concept models.","Instructions written for an AI agent to execute are agent skills, not knowledge articles for people."],"structure":{"bundles":[{"id":"KNW004-B1","name":"Content and scope","description":"What the article says and for whom.","layers":[{"id":"KNW004-B1-L1","name":"Subject and audience","description":"The question or issue the article addresses and its intended readers.","findings":[{"id":"KNW004-F01","name":"Covered issue","description":"The problem, question or task the article answers.","questions":[{"text":"Which question or issue does this article answer?","id":"KNW004-Q01"},{"text":"Which products, versions or situations is the answer valid for?","id":"KNW004-Q02"}]},{"id":"KNW004-F02","name":"Audience and visibility","description":"Who may read the article.","questions":[{"text":"Is the article for internal staff, partners or the public?","id":"KNW004-Q03"},{"text":"Does it contain content that must not leave its stated audience?","id":"KNW004-Q04"}]}]}]},{"id":"KNW004-B2","name":"Lifecycle and governance","description":"How the article is owned, reviewed and versioned.","layers":[{"id":"KNW004-B2-L1","name":"Versions and review","description":"Authorship, approval and review dates.","findings":[{"id":"KNW004-F03","name":"Current version","description":"The published version with its author and approver.","questions":[{"text":"Which version is currently published, and who approved it?","id":"KNW004-Q05"},{"text":"When is the next review due, and is it overdue?","id":"KNW004-Q06"}]},{"id":"KNW004-F04","name":"Retirement","description":"Whether the article is obsolete or superseded.","questions":[{"text":"Has the article been superseded or retired, and by what?","id":"KNW004-Q07"},{"text":"Do links or tickets still point to the retired version?","id":"KNW004-Q08"}]}]}]},{"id":"KNW004-B3","name":"Use and evidence","description":"How the article is used and whether it works.","layers":[{"id":"KNW004-B3-L1","name":"Usage and feedback","description":"Links to cases, ratings and corrections.","findings":[{"id":"KNW004-F05","name":"Usefulness","description":"Evidence that the article resolves the issue it covers.","questions":[{"text":"How many cases were resolved by linking this article?","id":"KNW004-Q09"},{"text":"Which feedback or reported errors are still open?","id":"KNW004-Q10"}]}]}]}]},"agentConduct":{"may":["Search, cite and link articles when answering questions or resolving cases.","Draft new articles or updates for human review.","Report articles that are outdated, contradictory or overdue for review.","Record which article version an answer relied on."],"mustNot":["Publish or change an approved article without the review its knowledge base requires.","Show an internal article to an audience it is not meant for.","Present a retired or superseded article as current guidance.","Invent steps or facts not found in the article when citing it.","Remove an author's attribution."],"requiresHuman":["Approving an article for publication.","Retiring an article that other processes or customers rely on."]},"ethics":{"considerations":["Wrong or outdated guidance spreads quickly when agents reuse it at scale.","Articles can hold personal or confidential data copied from cases.","Authors' work should be credited even in internal knowledge bases."],"affectedParties":["Readers relying on the guidance","Article authors and reviewers","Customers whose cases inform articles"]},"owners":{"steward":"The knowledge manager or content owner who answers for the accuracy and review of articles in a knowledge base.","roles":[{"name":"Knowledge steward","responsibilities":["Account for applicability, content standards and unresolved quality risks"]},{"name":"Contributor","responsibilities":["Draft grounded content and preserve attribution"]},{"name":"Reviewer","responsibilities":["Record scoped evidence-based review under the applicable policy"]},{"name":"Publisher","responsibilities":["Authorize audience-specific release or withdrawal without confusing it with review confidence"]},{"name":"Record custodian","responsibilities":["Implement retention, holds, access bindings and disposal evidence"]},{"name":"Reader or consuming agent","responsibilities":["Check revision and applicability; report defects; do not execute prose without separate authority"]}],"masterSystems":["Knowledge base","Content management system"]},"relations":[{"target":"WM-REC-001","type":"references","note":"Candidate binding to evidence/rendition records; record custody and generic disposal execution stay with their master. Pin the target before adoption."},{"target":"WM-ACT-021","type":"references","note":"Candidate permitted motivating/reuse case reference; case facts, outcomes and closure stay external. An article need not originate from a case."},{"target":"WM-KNW-005","type":"references","note":"Candidate link to separately governed executable instructions derived from or citing the article. Article retrieval provides no execution authority."},{"target":"https://schema.org/TechArticle","type":"aligned","note":"Conceptual mapping for technical articles only; select Article or another justified type for nontechnical content. Pin vocabulary release before implementation."},{"target":"https://www.dublincore.org/specifications/dublin-core/dcmi-terms/","type":"aligned","note":"Descriptive metadata mapping; version and format relationships retain their different meanings."},{"target":"https://www.w3.org/TR/prov-o/","type":"aligned","note":"Conceptual provenance and revision derivation mapping, without a conformance or truth claim."},{"target":"WM-REC-001 Document / Record","type":"neighbor","note":"Candidate reference for separately mastered evidence and renditions; this model owns article semantics, not general records management or storage operations."},{"target":"WM-ACT-021 Service Case / Ticket","type":"neighbor","note":"Candidate reference to a motivating or reuse case. Case identity and resolution outcome remain in the case master; linking an article does not prove it resolved a case."},{"target":"WM-KNW-005 Agent Skill / Instruction","type":"neighbor","note":"Candidate reference to an executable instruction contract. A person or agent can consume an article; consumption does not turn prose into execution authority."},{"target":"Policy, standard and concept masters","type":"neighbor","note":"The article may explain or reference these resources; it neither enacts their authority nor replaces their authoritative definitions."},{"target":"wm-rec-001-document-record","type":"related","note":"A knowledge article is a curated kind of document."},{"target":"wm-act-021-service-case-ticket","type":"references","note":"Articles are linked to the cases they help resolve."},{"target":"wm-knw-005-agent-skill-instruction","type":"neighbor","note":"Agent skills are instructions for machines, articles guidance for people."}],"interaction":{"identity":{"applicability":"required","items":["Identified by the knowledge base's article identifier and version number.","Public articles may also have a stable URL."]},"properties":{"applicability":"not-applicable","items":[]},"recognition":{"applicability":"optional","items":["Marked by a title, a stated question or issue, a body of guidance, an owner and a review date.","Often confused with a policy, a user manual, a forum thread or a ticket comment."]},"capabilities":{"applicability":"required","items":["Can be drafted, reviewed, published, updated and retired as versions.","Can be linked to cases, products and concepts, and rated by readers."]},"hazards":{"applicability":"required","items":["Outdated steps that cause errors or data loss when followed.","Leakage of confidential content to the wrong audience."]},"interfaces":{"applicability":"required","items":["Knowledge base search and retrieval APIs.","schema.org Article and TechArticle for public pages.","OASIS DITA for structured topic-based content."]},"context":{"applicability":"required","items":["Used in customer support, IT service management and internal documentation.","Increasingly used as grounding content for AI assistants."]}},"sources":[{"title":"KCS v6 Practices Guide - Technique 5.1: KCS Article Structure","url":"https://library.serviceinnovation.org/KCS/KCS_v6/KCS_v6_Practices_Guide/030/040/010/020","note":"Consortium for Service Innovation"},{"title":"KCS v6 Practices Guide - Technique 5.2: KCS Article State","url":"https://library.serviceinnovation.org/KCS/KCS_v6/KCS_v6_Practices_Guide/030/040/010/030","note":"Consortium for Service Innovation"},{"title":"KCS v6 Practices Guide - Technique 4.1: Reuse is Review","url":"https://library.serviceinnovation.org/KCS/KCS_v6/KCS_v6_Practices_Guide/030/030/040/020","note":"Consortium for Service Innovation"},{"title":"TechArticle","url":"https://schema.org/TechArticle","note":"Schema.org community"},{"title":"DCMI Metadata Terms","url":"https://www.dublincore.org/specifications/dublin-core/dcmi-terms/","note":"Dublin Core Metadata Initiative"},{"title":"PROV-O: The PROV Ontology","url":"https://www.w3.org/TR/prov-o/","note":"World Wide Web Consortium"},{"title":"Web Content Accessibility Guidelines (WCAG) 2.2","url":"https://www.w3.org/TR/WCAG22/","note":"World Wide Web Consortium"},{"title":"Date and Time on the Internet: Timestamps","url":"https://www.rfc-editor.org/rfc/rfc3339","note":"Internet Engineering Task Force"},{"title":"Knowledge-Centered Service (KCS) practices, Consortium for Service Innovation"},{"title":"Darwin Information Typing Architecture (DITA), OASIS"}],"openQuestions":["Verify direct source responses, final URLs, immutable or dated source versions, license conditions and the exact admitted claim support outside the sandbox.","Develop nested schemas and test fixtures for incomplete answers, stale translations, concurrent edits, restricted attachments, false success attribution, supersession, lawful erasure and lossy exports.","Validate adopting profiles and restore independent external review before any canonical or publishable-draft promotion.","Independent second-provider review is absent; only local Codex research and a separate self-audit are available","Direct HTTP checks are unperformed under the owner-reported sandbox block; live bytes, redirects and version pins need coordinator verification","Nested instance schemas, tested mappings, localization synchronization and representative operational fixtures remain to be developed","Adoption-specific rights, privacy, retention, accessibility, regulated-content and review authority require qualified policy review","DITA and other content-system bindings from the supplement were not verified and are not admitted"],"resources":{"spec":"/models/wm-knw-004-knowledge-article/spec.yaml","agents":"/models/wm-knw-004-knowledge-article/AGENTS.md","source":"https://github.com/ver-cy/world-models/tree/feat/mega-model-registry/research/runs/wm-knw-004"},"provenance":{"origin":"world-models research","builtFrom":["models/wm-knw-004-knowledge-article/spec.yaml","ver-cy/world-models/card-supplements/wm-knw-004-knowledge-article.json"],"providers":["Codex"],"researchStatus":"reviewable-draft","generatedAt":"2026-10-06T15:04:04Z","builder":"tools/build_cards.py@1.0.0"},"completeness":{"sections":{"classifiers":"filled","whatItIs":"filled","purpose":"filled","distinguishingFeatures":"filled","structure":"filled","agentConduct":"filled","ethics":"filled","owners":"filled","relations":"filled","interaction.identity":"filled","interaction.properties":"not-applicable","interaction.recognition":"filled","interaction.capabilities":"filled","interaction.hazards":"filled","interaction.interfaces":"filled","interaction.context":"filled","sources":"filled"},"notes":{"interaction.properties":"The subject is an institutional or informational record with no physical quantities of its own.","_supplement":"Sections authored in card supplement 1.0.1 by Claude (Opus 5.5) (2026-10-06, unreviewed). Written from the card's existing content and established practice in the field; no new sources were read. Unreviewed."},"score":1.0}}