Jump to content

AOWIS:AI Usage Guide/v1.0: Difference between revisions

From AOWIS
No edit summary
No edit summary
Line 11: Line 11:
This document defines how Artificial Intelligence (AI) tools MAY be used in the creation, modification, and review of AOWIS documentation and system designs.
This document defines how Artificial Intelligence (AI) tools MAY be used in the creation, modification, and review of AOWIS documentation and system designs.


It establishes boundaries to ensure that all outputs remain verifiable, controlled, and compliant with AOWIS standards.
AOWIS is an Open Standard developed and curated by human experts. All submission will be checked and validated by human experts. The use of AI tools is acceptable only when assisting humans with spelling, grammar, or language clarity. It is strongly discouraged to let AI automatically "correct" whole texts or even paragraphs, and then just copy and paste it into the Wiki, because this will result in "hallucinations" (false, made up content) sneaking into the Wiki. If you want to use AI to check your grammar and spelling or your language and tone in general, the suggested way is to ask it to point out to you suggestions to change, and you change it manually yourself if you find the suggestions helpful.
 
Replacing any sorts of actual research by AI hallucinated texts is strongly prohibited.
 
If AOWIS staff detect AI-generated content in any submission, enforcement actions may be taken depending on severity. Detection may be based on the judgment of staff members, as determining AI usage is not always fully certain. When staff reasonably conclude that a violation has occurred, this may result in rejection of the submission, a warning, or suspension of the contributor’s account.


----
----
Line 18: Line 22:


<pre>
<pre>
REQ-AI-001: AI-generated content MUST be reviewed by a human before inclusion in any normative AOWIS document.
REQ-AI-001: All AI-assisted content MUST originate from human authors. Human contributors remain responsible for the content they submit.
REQ-AI-002: AI MUST NOT be considered a source of truth for normative requirements.
 
REQ-AI-003: All normative statements MUST be validated against the AOWIS Writing Style Guide before acceptance.
REQ-AI-002: AI MAY be used to suggest improvements in spelling, grammar, tone, or structure, but MUST NOT generate complete sections or research content without human authorship.
REQ-AI-004: AI MAY be used to draft explanatory text.
 
REQ-AI-005: AI MAY be used to suggest normative statements, but such statements MUST be independently verified.
REQ-AI-003: AI-assisted content MUST be reviewed and manually applied by the contributor before inclusion in any AOWIS document.
REQ-AI-006: AI-generated normative statements MUST be assigned unique requirement identifiers by a human.
 
REQ-AI-007: AI MUST NOT introduce normative requirements outside the "Requirements" section.
REQ-AI-004: Contributors MUST NOT copy AI outputs directly into the wiki without substantive human review.
REQ-AI-008: AI-generated content MUST be checked for ambiguity, non-testable statements, prohibited terms, and mixed tone violations.
 
REQ-AI-009: AI MUST NOT be used as the sole mechanism for safety-critical design decisions.
REQ-AI-005: AOWIS staff MAY review submissions. Detection MAY be based on staff judgment, and reasonable conclusions of AI misuse MAY result in warnings, rejection, or suspension of contributor privileges.
REQ-AI-010: All safety-critical logic MUST be reviewed and approved by a qualified human reviewer.
REQ-AI-011: AI MAY be used to improve clarity, grammar, and structure of existing text, provided meaning is not altered.
REQ-AI-012: AI MUST NOT modify requirement semantics without explicit human approval.
REQ-AI-013: AI usage MUST be disclosed in the document revision history.
REQ-AI-014: AI-generated examples MUST be realistic and reflect low-infrastructure environments.
REQ-AI-015: AI MUST NOT generate or modify requirement identifiers without human verification.
REQ-AI-016: AI MAY be used for brainstorming, idea generation, and outline creation.
REQ-AI-017: AI MAY be used to correct spelling, grammar, and formatting.
REQ-AI-018: AI MAY be used to transform text into formal or structured language.
REQ-AI-019: AI-generated content MUST be reviewed, modified, and approved by a human before inclusion.
REQ-AI-020: Content MUST NOT be copied from AI outputs into the wiki without substantive human modification.
REQ-AI-021: A contribution MUST be considered non-compliant if it contains AI-generated content that has not been reviewed or modified by a human.
REQ-AI-022: Project maintainers MAY reject or remove contributions that do not meet REQ-AI-019 and REQ-AI-020.
REQ-AI-023: Repeated submission of non-compliant AI-generated content MAY result in loss of contribution privileges.
REQ-AI-024: All accepted content MUST be attributable to a human contributor who takes responsibility for its correctness.
</pre>
</pre>
</pre>


Line 49: Line 37:
== Definitions ==
== Definitions ==


'''Artificial Intelligence (AI)'''
'''Artificial Intelligence (AI)''': A software system capable of generating text, suggestions, or structured outputs based on input prompts.
A software system capable of generating text, suggestions, or structured outputs based on input prompts.


'''AI-Generated Content'''
'''AI-Generated Content''': Any text, structure, or data produced by an AI system.
Any text, structure, or data produced by an AI system.


'''Human Reviewer'''
'''Human Reviewer''': A person responsible for verifying correctness, compliance, and safety of content.
A person responsible for verifying correctness, compliance, and safety of content.


'''Normative Content'''
'''Normative Content''': Content that defines requirements using MUST, SHOULD, or MAY.
Content that defines requirements using MUST, SHOULD, or MAY.


----
----

Revision as of 18:58, 5 April 2026


Warning: Display title "AOWIS AI Usage Guide (v1.0)" overrides earlier display title "AI Usage Guide v1.0".

Guidelines for controlled and verifiable use of AI in AOWIS.


Purpose

This document defines how Artificial Intelligence (AI) tools MAY be used in the creation, modification, and review of AOWIS documentation and system designs.

AOWIS is an Open Standard developed and curated by human experts. All submission will be checked and validated by human experts. The use of AI tools is acceptable only when assisting humans with spelling, grammar, or language clarity. It is strongly discouraged to let AI automatically "correct" whole texts or even paragraphs, and then just copy and paste it into the Wiki, because this will result in "hallucinations" (false, made up content) sneaking into the Wiki. If you want to use AI to check your grammar and spelling or your language and tone in general, the suggested way is to ask it to point out to you suggestions to change, and you change it manually yourself if you find the suggestions helpful.

Replacing any sorts of actual research by AI hallucinated texts is strongly prohibited.

If AOWIS staff detect AI-generated content in any submission, enforcement actions may be taken depending on severity. Detection may be based on the judgment of staff members, as determining AI usage is not always fully certain. When staff reasonably conclude that a violation has occurred, this may result in rejection of the submission, a warning, or suspension of the contributor’s account.


Requirements

REQ-AI-001: All AI-assisted content MUST originate from human authors. Human contributors remain responsible for the content they submit.

REQ-AI-002: AI MAY be used to suggest improvements in spelling, grammar, tone, or structure, but MUST NOT generate complete sections or research content without human authorship.

REQ-AI-003: AI-assisted content MUST be reviewed and manually applied by the contributor before inclusion in any AOWIS document.

REQ-AI-004: Contributors MUST NOT copy AI outputs directly into the wiki without substantive human review.

REQ-AI-005: AOWIS staff MAY review submissions. Detection MAY be based on staff judgment, and reasonable conclusions of AI misuse MAY result in warnings, rejection, or suspension of contributor privileges.

Definitions

Artificial Intelligence (AI): A software system capable of generating text, suggestions, or structured outputs based on input prompts.

AI-Generated Content: Any text, structure, or data produced by an AI system.

Human Reviewer: A person responsible for verifying correctness, compliance, and safety of content.

Normative Content: Content that defines requirements using MUST, SHOULD, or MAY.


Notes

AI can accelerate drafting and improve clarity, but it does not understand real-world constraints, failure modes, or safety implications.

In low-resource environments, incorrect assumptions can lead to system failure. Human oversight ensures that designs remain grounded in operational reality.

AI is most effective when used for:

  • Structuring documents
  • Rewriting unclear text
  • Generating examples
  • Identifying inconsistencies

AI is least reliable when used for:

  • Safety-critical reasoning
  • Context-specific engineering decisions

End of AI Usage Guide (v1.0)