Docs upgrade

.editorconfig

@@ -0,0 +1,10 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false

.github/ISSUE_TEMPLATE/change.yml

@@ -0,0 +1,17 @@
+name: Change request
+description: Propose a controlled change to AI-OS
+title: "[Change]: "
+labels: ["change"]
+body:
+  - type: textarea
+    id: goal
+    attributes:
+      label: Goal
+    validations:
+      required: true
+  - type: textarea
+    id: verification
+    attributes:
+      label: Verification
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Security report
+    url: https://github.com/Coding-Autopilot-System/ai-engineering-operating-system/security/advisories/new
+    about: Report security-sensitive issues privately.

.github/ISSUE_TEMPLATE/docs_gap.yml

@@ -0,0 +1,25 @@
+name: Documentation gap
+description: Report missing, confusing, or stale documentation
+title: "[Docs]: "
+labels: ["documentation"]
+body:
+  - type: textarea
+    id: gap
+    attributes:
+      label: Gap
+      description: What is missing or unclear?
+    validations:
+      required: true
+  - type: textarea
+    id: location
+    attributes:
+      label: Location
+      description: Link or path if known.
+    validations:
+      required: false
+  - type: textarea
+    id: done
+    attributes:
+      label: Definition of done
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,25 @@
+name: Feature request
+description: Propose a new loop, verifier, prompt, example, or integration
+title: "[Feature]: "
+labels: ["enhancement"]
+body:
+  - type: textarea
+    id: goal
+    attributes:
+      label: Goal
+      description: What should improve?
+    validations:
+      required: true
+  - type: textarea
+    id: plan
+    attributes:
+      label: Proposed plan
+      description: Describe the loop, files, and verification you expect.
+    validations:
+      required: true
+  - type: textarea
+    id: acceptance
+    attributes:
+      label: Acceptance criteria
+    validations:
+      required: true

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,47 @@
+# Summary
+
+Explain the goal and what changed.
+
+# Loop used
+
+- [ ] Feature
+- [ ] Bug fix
+- [ ] Refactoring
+- [ ] CI/CD repair
+- [ ] Security
+- [ ] Documentation
+- [ ] Release
+- [ ] Continuous improvement
+
+# Plan approval
+
+- [ ] Plan was stated before implementation
+- [ ] Human approval was requested where needed
+- [ ] No risky or irreversible change was made without approval
+
+# Verification evidence
+
+| Gate | Evidence |
+|---|---|
+| Structure check | |
+| Docs check | |
+| Mermaid check | |
+| Security review | |
+| Link check | |
+
+# Documentation
+
+- [ ] README updated if needed
+- [ ] Docs updated if needed
+- [ ] Wiki navigation updated if needed
+- [ ] ADR added if needed
+
+# Risk and rollback
+
+Risk level: LOW / MEDIUM / HIGH
+
+Rollback plan:
+
+# Remaining work
+
+List anything intentionally left out.

.github/dependabot.yaml

@@ -0,0 +1,10 @@
+version: 2
+updates:
+- package-ecosystem: github-actions
+  directory: /
+  schedule:
+    interval: weekly
+- package-ecosystem: pip
+  directory: /
+  schedule:
+    interval: weekly

.github/workflows/ci-docs.yml

@@ -0,0 +1,23 @@
+name: ci-docs
+
+on:
+  pull_request:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  docs-quality:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+      - name: Verify repository structure
+        run: python scripts/verify_repo.py
+      - name: Run structure tests
+        run: python -m pytest tests

.github/workflows/dependency-review.yml

@@ -0,0 +1,15 @@
+name: dependency-review
+
+on:
+  pull_request:
+
+permissions:
+  contents: read
+  pull-requests: read
+
+jobs:
+  dependency-review:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/dependency-review-action@v4

.github/workflows/release.yml

@@ -0,0 +1,34 @@
+name: release
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: Semantic version tag such as v1.0.0
+        required: true
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    environment: release
+    steps:
+      - uses: actions/checkout@v4
+      - name: Validate version
+        run: |
+          python - <<'PY'
+          import os, re
+          version = os.environ['VERSION']
+          if not re.fullmatch(r'v[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z.-]+)?', version):
+              raise SystemExit('Invalid version: ' + version)
+          print(version)
+          PY
+        env:
+          VERSION: ${{ inputs.version }}
+      - name: Create release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          VERSION: ${{ inputs.version }}
+        run: gh release create "$VERSION" --title "$VERSION" --generate-notes

.markdownlint.json

@@ -0,0 +1,5 @@
+{
+  "MD013": false,
+  "MD033": false,
+  "MD041": true
+}

CHANGELOG.md

@@ -0,0 +1,17 @@
+# Changelog
+
+All notable changes to AI-OS will be documented here.
+
+The format follows a human-readable release log and versions follow `VERSIONING.md`.
+
+## Unreleased
+
+### Added
+
+- Production-grade governance files.
+- Continuous improvement loop documentation.
+- Expanded loop, verifier, prompt, wiki, and CI/CD structure.
+
+### Changed
+
+- README now positions AI-OS as a loop-engineered, verification-driven operating model.

CODEOWNERS

@@ -0,0 +1,8 @@
+* @ogeonx
+/.github/ @ogeonx
+/docs/ @ogeonx
+/prompts/ @ogeonx
+/wiki/ @ogeonx
+/adr/ @ogeonx
+/scripts/ @ogeonx
+/tests/ @ogeonx

CODE_OF_CONDUCT.md

@@ -0,0 +1,21 @@
+# Code of Conduct
+
+This project uses a simple professional conduct standard.
+
+## Expected behavior
+
+- Be respectful and constructive.
+- Focus criticism on ideas, evidence, and implementation quality.
+- Prefer clear improvement proposals over vague objections.
+- Assume good intent, but verify technical claims.
+
+## Unacceptable behavior
+
+- Harassment, threats, or abuse.
+- Publishing private information.
+- Repeated disruption of technical discussion.
+- Attempts to bypass security or approval processes.
+
+## Enforcement
+
+Maintainers may edit, close, hide, or remove contributions that violate this standard. Serious issues should be reported through the security or support channels.

CONTRIBUTING.md

@@ -0,0 +1,35 @@
+# Contributing
+
+AI-OS contributions must improve clarity, safety, repeatability, or verification.
+
+## Contribution loop
+
+```mermaid
+flowchart TD
+    Idea[Idea] --> Issue[Open Issue]
+    Issue --> Plan[Write Plan]
+    Plan --> Approval{Maintainer Approval Needed?}
+    Approval -- Yes --> Review[Human Review]
+    Approval -- No --> Branch[Create Branch]
+    Review --> Branch
+    Branch --> Change[Make Small Change]
+    Change --> Verify[Run Verifiers]
+    Verify --> Pass{Passed?}
+    Pass -- No --> Fix[Fix and Re-run]
+    Fix --> Verify
+    Pass -- Yes --> PR[Open PR]
+    PR --> Done[Review and Merge]
+```
+
+## Required for PRs
+
+- Clear goal
+- Scope and non-goals
+- Verification evidence
+- Updated docs when behavior changes
+- Mermaid diagrams for new workflows
+- Human approval for broad governance, release, or security changes
+
+## Canonical source
+
+The `/docs` tree is canonical. Wiki pages are curated navigation pages that point back to canonical docs.

GOVERNANCE.md

@@ -0,0 +1,35 @@
+# Governance
+
+AI-OS governance is based on explicit goals, human approval gates, verification evidence, and reversible change.
+
+## Governance loop
+
+```mermaid
+flowchart TD
+    Proposal[Proposal] --> Impact[Impact Analysis]
+    Impact --> Risk[Risk Classification]
+    Risk --> Plan[Implementation Plan]
+    Plan --> Approval{Human Approval Required?}
+    Approval -- Yes --> Human[Maintainer Approval]
+    Approval -- No --> Implement[Implement]
+    Human --> Implement
+    Implement --> Verify[Verify]
+    Verify --> Pass{Pass?}
+    Pass -- No --> Rework[Rework]
+    Rework --> Verify
+    Pass -- Yes --> Record[Record Decision]
+    Record --> Done[Done]
+```
+
+## Approval required
+
+- Release process changes
+- Security policy changes
+- Governance changes
+- Breaking changes to master prompt semantics
+- Automation that can mutate repositories
+- Anything that increases risk or cost
+
+## Decision records
+
+Use ADRs for structural decisions. ADRs must explain context, decision, alternatives, consequences, and rollback.

MAINTAINERS.md

@@ -0,0 +1,22 @@
+# Maintainers
+
+## Current maintainer
+
+- @ogeonx
+
+## Maintainer responsibilities
+
+- Preserve the canonical AI-OS operating model.
+- Review governance, security, release, and master prompt changes.
+- Require verification evidence for meaningful PRs.
+- Keep `/docs` canonical and wiki pages curated.
+- Avoid merging unsafe autonomous-action patterns.
+
+## Maintainer review checklist
+
+- Is the goal clear?
+- Is the change reversible?
+- Are verifiers documented?
+- Are diagrams updated?
+- Is human approval needed?
+- Does the change improve the repo without unnecessary complexity?