@raishin/vanguard-frontier-agentic 1.1.0 → 1.3.0

package/skills/kyverno/kyverno-policy-review/references/workflow-and-output.md

@@ -0,0 +1,106 @@
+# Workflow and Output Contract
+
+## Workflow
+
+### Step 1 — Identify the policy and its scope
+
+1. Confirm the policy kind: `ValidatingPolicy`, `MutatingPolicy`, `GeneratingPolicy`, `DeletingPolicy`, `ImageValidatingPolicy` (stable `policies.kyverno.io/v1`), or legacy `ClusterPolicy` / `Policy`.
+2. Confirm the match scope: namespace-scoped (`Policy`) vs cluster-scoped (`ClusterPolicy` / new v1 kinds).
+3. Confirm the API version. The stable `policies.kyverno.io/v1` API is the recommended target — see the [Kyverno policy types overview](https://kyverno.io/docs/policy-types/overview/).
+4. Confirm match conditions in `spec.match` — kinds, names, namespaces, labels, annotations. Any `kinds: ['*']` with no further filter is high-blast-radius.
+
+### Step 2 — Identify the failure mode
+
+1. Locate `spec.rules[].validate.failureAction` (newer API) or `spec.validationFailureAction` (legacy).
+2. Two values exist: `Enforce` (admission denied on violation) and `Audit` (admission allowed, violation recorded in PolicyReport).
+3. **Critical finding**: any production-relevant policy with `failureAction: Audit` and no plan to migrate to `Enforce`. The policy is a logging shim, not a control.
+4. Also confirm `spec.background` — when `false`, the policy only evaluates at admission time; existing resources are not scanned.
+5. Reference: [Validate rules — failureAction semantics](https://kyverno.io/docs/policy-types/cluster-policy/validate/).
+
+### Step 3 — Challenge dangerous policy patterns
+
+Flag the following as high-severity findings:
+
+- **`failureAction: Audit` in production** — silent allow path; PolicyReports accumulate without enforcement.
+- **`background: false` + match scope that does not match admission requests** — policy never runs; effectively dead code.
+- **`match` with `kinds: ['*']` and no namespace selector** — cluster-wide blast radius; one mis-written CEL expression breaks every admission.
+- **`exclude` clause that exempts entire `kube-system` or operator namespaces** — operators bypass policy that should still apply (e.g., image signing).
+- **`failurePolicy: Ignore` on the underlying ValidatingWebhookConfiguration** — Kyverno controller failures silently allow. See the [Kubernetes admission webhook reference](https://kubernetes.io/docs/reference/access-authn-authz/extensible-admission-controllers/).
+- **CEL expressions referencing `request.userInfo` without a deny default** — easy to bypass with a service account named in an exception.
+
+### Step 4 — Audit every PolicyException
+
+A PolicyException is a documented bypass. Treat every one as audit evidence requiring four facts:
+
+1. **Owner**: who created it and is on call for the exempted resources?
+2. **Reason**: why does this resource not meet the policy?
+3. **Expiry**: is there a date or condition under which this exception is removed? Kyverno does not enforce expiry — this must be a documented commitment.
+4. **Scope**: which resources, namespaces, and rules are exempted?
+
+Reference: [Kyverno PolicyExceptions](https://kyverno.io/docs/exceptions/).
+
+Stress-test exceptions:
+
+- An exception with `match.any.resources.kinds: ['*']` exempts everything — almost always too broad.
+- An exception that exempts the `default` ServiceAccount — effectively exempts every workload that hasn't bound an SA.
+- An exception that exempts a `ClusterPolicy` with `failureAction: Enforce` quietly demotes the policy to `Audit` for the matched scope.
+
+### Step 5 — Audit ImageValidatingPolicy specifically
+
+For `ImageValidatingPolicy` (and legacy `verifyImages` rules), confirm:
+
+1. **Public key or KMS key reference** is present and points to a real attestation root (Sigstore / Cosign / Notary / KMS-backed).
+2. **`mutateDigest: true`** — replaces the mutable image tag with the immutable digest at admission. Without this, the verified image can be replaced after admission.
+3. **`verifyDigest: true`** — re-checks the digest against the verified attestation chain.
+4. **`required: true`** on the verification rule — without this, missing signatures pass.
+5. **`match` covers all production registries**, not just public Docker Hub.
+6. **No `imageReferences: ['*']` with `skip: true`** — total signature bypass.
+
+Reference: [Kyverno verify-images / ImageValidatingPolicy](https://kyverno.io/docs/policy-types/cluster-policy/verify-images/).
+
+### Step 6 — Evaluate Kyverno vs native ValidatingAdmissionPolicy (CEL)
+
+Native `ValidatingAdmissionPolicy` (CEL) shipped stable in Kubernetes 1.30 ([reference](https://kubernetes.io/docs/reference/access-authn-authz/validating-admission-policy/)). Kyverno can compile its own policies into native VAP — see [Kyverno docs on VAP generation](https://kyverno.io/docs/policy-types/cluster-policy/validate/).
+
+Choose **native VAP** when:
+
+- The policy is pure validation (no mutation, no generation, no image verification, no cleanup).
+- The CEL expression alone is sufficient — no JMESPath, no API lookup, no `context.apiCall`, no foreach.
+- You want fewer moving parts in the admission path (no Kyverno controller).
+
+Stay with **Kyverno** when:
+
+- You need mutation, generation, cleanup, or image verification.
+- You need cross-resource lookups (`context.apiCall`).
+- You need PolicyReports for compliance evidence.
+- You need PolicyExceptions managed declaratively.
+
+Recommend a path explicitly. "Could be native VAP" without a recommendation is incomplete review.
+
+### Step 7 — Stress-test operational hygiene
+
+- Prefer policies authored with `policies.kyverno.io/v1` over legacy `kyverno.io/v1` — the new API is the long-term path.
+- Prefer explicit `match.any.resources.kinds` lists over wildcards.
+- Prefer policies with `background: true` so existing resources are scanned (catches drift).
+- Prefer policies that emit clear `message` text — admission rejections show this string to the user, and a vague rejection message wastes engineer time.
+- Reports Server should be installed when policy reports are needed at scale — etcd-backed PolicyReports do not scale beyond a few thousand violations. See [Kyverno installation](https://kyverno.io/docs/installation/).
+
+## Output
+
+Return:
+
+- **target**: policy kind, name, match scope, and API version,
+- **evidence level**: `live evidence` / `documentation-based` / `sanitized user evidence` / `inference`,
+- **failure mode**: `Enforce` vs `Audit`, with judgment on whether this matches production posture,
+- **risk findings** (with severity: high / medium / low) — including PolicyException audit, image verification posture, wildcard match, and admission webhook failurePolicy,
+- **architectural recommendation**: stay with Kyverno, migrate to native VAP, or hybrid — with reason,
+- **safest next actions** with sample manifest changes,
+- **rollback plan**: how to remove or revert the policy without breaking running workloads,
+- **assumptions and missing facts**.
+
+## Security notes
+
+- Never recommend `failureAction: Audit` for a production-tier policy unless there is a written rollout plan to `Enforce` with a date.
+- Never recommend exempting `cluster-admin`, the controller's own ServiceAccount, or wildcards in PolicyExceptions.
+- Never recommend disabling image signature verification "temporarily" without a tracked re-enable date.
+- Do not print Cosign private keys, Rekor signature blobs, or registry credentials. Reference key names only.

package/skills/oci/README.md

@@ -0,0 +1,63 @@
+# 🟥 OCI Skills
+
+<p align="center">
+  <img src="../../assets/logos/cloud/oci/oracle-cloud-infrastructure.png" alt="Oracle Cloud Infrastructure logo" width="140" />
+</p>
+
+This folder contains OCI-focused skills curated for this marketplace.
+
+## Local marketplace portfolio
+
+This folder contains **37** local OCI skills:
+
+- `oci-autonomous-database-architect`
+- `oci-cloud-guard-responder`
+- `oci-compute-instance-agent-operator`
+- `oci-compute-platform-operator`
+- `oci-cost-finops-analyst`
+- `oci-database-platform-dba`
+- `oci-dbtools-sql-analyst`
+- `oci-devops-container-platform-engineer`
+- `oci-exadata-database-architect`
+- `oci-exadata-platform-architect`
+- `oci-fusion-apps-environment-operator`
+- `oci-goldengate-replication-operator`
+- `oci-identity-access-governor`
+- `oci-iot-digital-twin-engineer`
+- `oci-limits-capacity-planner`
+- `oci-live-autonomous-db-lifecycle-guard`
+- `oci-live-cost-budget-runaway-guard`
+- `oci-live-iam-policy-compartment-guard`
+- `oci-live-network-security-rule-guard`
+- `oci-live-oke-rollout-guard`
+- `oci-live-resource-manager-stack-guard`
+- `oci-live-vault-key-destruction-guard`
+- `oci-load-balancer-traffic-engineer`
+- `oci-maestro`
+- `oci-migration-cutover-architect`
+- `oci-multi-cloud-architect`
+- `oci-mysql-heatwave-ai-specialist`
+- `oci-network-architect`
+- `oci-observability-incident-responder`
+- `oci-recovery-service-operator`
+- `oci-registry-artifact-governor`
+- `oci-resource-search-inventory-analyst`
+- `oci-security-compliance-reviewer`
+- `oci-solution-architect`
+- `oci-storage-backup-steward`
+- `oci-support-incident-coordinator`
+- `oracle-oci-mcp-grounded-advisor`
+
+## Portfolio posture
+
+Role-based OCI skills for evidence-backed architecture, database operations, security, networking, FinOps, identity governance, and guarded live-environment operations.
+
+These skills are intentionally conservative:
+
+- prefer `oracle-oci-mcp-grounded-advisor` via OCI MCP server when available for live OCI state grounding
+- prefer read-only discovery before mutation
+- require explicit OCID, compartment, tenancy confirmation, approval, rollback posture, and verification for guarded live actions
+- challenge overly broad IAM policies, missing compartment isolation, public exposure, and unclear resource ownership
+- use official OCI documentation and live CLI evidence when service behavior matters
+
+Run `npm run validate` after changing cataloged OCI skills.

package/skills/oci/oci-certificates-issuer-review/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: oci-certificates-issuer-review
+description: Use this skill when reviewing OCI Certificates Service issuer configurations for cert-manager on OKE. Trigger on any request to audit OCI CA hierarchy, issuance rules, OKE Workload Identity vs Instance Principal auth, IAM policy scope, OCSP reachability, or certificate version management.
+metadata:
+  author: "github: Raishin"
+  version: "0.1.0"
+---
+
+# OCI Certificates Issuer Review
+
+## Purpose
+
+Review Oracle Cloud Infrastructure (OCI) Certificates Service configurations used as cert-manager issuers on OKE (Oracle Kubernetes Engine). Identify CA hierarchy misconfigurations (root vs subordinate), missing issuance rules, overly broad IAM policies, Instance Principal authentication scope risks, OCSP reachability gaps, and certificate version accumulation. Output severity-labeled findings with evidence and remediation steps.
+
+## Lean operating rules
+
+- Flag any OCI issuer that references a ROOT CA directly as CRITICAL — only a SUBORDINATE CA should be used for cert-manager issuance. The ROOT CA must be offline (disabled after subordinate creation) or kept entirely out of the Certificates Service.
+- Check whether OCI issuance rules are configured on the subordinate CA: flag missing validity caps (>90d) and missing key algorithm restrictions (RSA <2048 or EC <P-256) as MEDIUM.
+- Identify the authentication method used by cert-manager to call OCI APIs: flag Instance Principal auth as HIGH — any pod on the OKE node can call the OCI Certificates API via instance metadata. Correct method is OKE Workload Identity (SA-bound, pod-level).
+- Review the OCI IAM policy for cert-manager: flag `manage certificate-authorities` (grants delete/update CA) as HIGH. Minimum required: `use certificate-authorities` with `request.permission='CREATE_CERTIFICATE_REQUEST'`.
+- Check OCSP reachability from OKE worker nodes to `ocsp.pki.oraclecloud.com`. Flag unreachable OCSP endpoint as MEDIUM (soft-fail revocation = revoked certs accepted by most TLS stacks).
+- Review certificate version count; flag high version accumulation (> 10 versions per cert) as LOW (storage cost and management overhead).
+- Label all findings as live evidence, documentation-based, or inference.
+
+## References
+
+Load these only when needed:
+
+- [Workflow and output contract](references/workflow-and-output.md)
+
+## Response minimum
+
+- Severity-labeled findings list (CRITICAL / HIGH / MEDIUM / LOW)
+- Evidence source for each finding
+- Specific resource name, CA OCID, or IAM policy statement that caused the finding
+- Recommended remediation with example OCI CLI command or IAM policy snippet
+- Overall OCI PKI trust posture verdict

package/skills/oci/oci-certificates-issuer-review/metadata.json

@@ -0,0 +1,20 @@
+{
+  "id": "oci-certificates-issuer-review",
+  "name": "OCI Certificates Issuer Review",
+  "type": "skill",
+  "provider": "oci",
+  "harnesses": ["codex", "claude-code", "cursor", "gemini", "kiro", "other"],
+  "summary": "Review OCI Certificates Service issuer configurations for cert-manager on OKE, covering CA hierarchy safety, issuance rule enforcement, OKE Workload Identity vs Instance Principal authentication, IAM policy scope minimization, OCSP reachability, and certificate version lifecycle management.",
+  "source_type": "original",
+  "official_docs": [
+    "https://docs.oracle.com/en-us/iaas/Content/certificates/home.htm",
+    "https://docs.oracle.com/en-us/iaas/Content/certificates/managing-certificate-authority.htm",
+    "https://docs.oracle.com/en-us/iaas/Content/ContEng/Tasks/contengusingworkloadidentity.htm",
+    "https://github.com/oracle/oci-native-ingress-controller"
+  ],
+  "security_notes": "Instance Principal auth for cert-manager on OKE means ANY pod on the node can call the OCI Certificates API using the instance metadata endpoint — not just cert-manager. Use OKE Workload Identity to scope cert-issuance permissions to the cert-manager ServiceAccount only. IAM policy with 'manage certificate-authorities' grants delete and update CA permissions, which is excessive for cert-manager.",
+  "last_verified": "2026-05-02",
+  "path": "skills/oci/oci-certificates-issuer-review",
+  "author": "github: Raishin",
+  "version": "0.1.0"
+}

package/skills/oci/oci-certificates-issuer-review/references/workflow-and-output.md

@@ -0,0 +1,207 @@
+# Workflow and Output Contract
+
+## Review Workflow
+
+### Step 1 — Identify the CA and issuer configuration
+
+Retrieve the OCI cert-manager issuer resource:
+
+```bash
+kubectl get issuer -A -o yaml | grep -A20 "oci\|oracle"
+kubectl get clusterissuer -o yaml | grep -A20 "oci\|oracle"
+```
+
+Extract the CA OCID from the issuer spec. Then inspect the CA in OCI:
+
+```bash
+oci certs-mgmt certificate-authority get \
+  --certificate-authority-id <ca-ocid>
+```
+
+Key fields to check:
+- `type` — must be `SUBORDINATE` (not `ROOT`)
+- `lifecycleState` — must be `ACTIVE`
+- `issuerCertificateAuthorityId` — should reference a ROOT CA that is itself INACTIVE or not used for direct issuance
+
+### Step 2 — Validate CA type (root vs subordinate)
+
+```bash
+oci certs-mgmt certificate-authority get \
+  --certificate-authority-id <ca-ocid> \
+  --query data.config-type \
+  --raw-output
+```
+
+Expected values:
+- `SUBORDINATE_CA_ISSUED_BY_INTERNAL_CA` — correct for cert-manager usage
+- `ROOT_CA_GENERATED_INTERNALLY` — CRITICAL finding; root directly exposed to cert-manager
+
+Also check the issuer CA's status:
+```bash
+oci certs-mgmt certificate-authority get \
+  --certificate-authority-id <ca-ocid> \
+  --query data.lifecycle-state \
+  --raw-output
+```
+
+### Step 3 — Review issuance rules
+
+List issuance rules configured on the CA:
+
+```bash
+oci certs-mgmt certificate-authority get \
+  --certificate-authority-id <ca-ocid> \
+  --query "data.certificate-authority-rules"
+```
+
+Check for:
+
+```json
+{
+  "ruleType": "CERTIFICATE_AUTHORITY_MAX_VALIDITY_RULE",
+  "certificateMaxValidityDuration": "P90D"
+}
+```
+
+And key algorithm restriction:
+
+```json
+{
+  "ruleType": "CERTIFICATE_AUTHORITY_ISSUANCE_EXPIRY_RULE",
+  "leafCertificateMaxValidityDuration": "P90D",
+  "certificateAuthorityMaxValidityDuration": "P3650D"
+}
+```
+
+**Flags:**
+- No issuance rules configured (no validity cap) — MEDIUM (cert-manager can issue 10-year workload certs)
+- Max validity > 365d for leaf certificates — MEDIUM
+- No key algorithm restriction — MEDIUM (RSA-1024 issuance possible)
+
+### Step 4 — Identify authentication method
+
+Check the cert-manager configuration for OCI auth method:
+
+```bash
+# Check if OKE Workload Identity is configured
+kubectl get serviceaccount cert-manager -n cert-manager \
+  -o jsonpath='{.metadata.annotations}'
+```
+
+For OKE Workload Identity, the ServiceAccount should have OCI annotations:
+
+```yaml
+annotations:
+  oci.oraclecloud.com/role-binding: "<dynamic-group-name>"
+```
+
+For Instance Principal auth, check if the cert-manager pod uses the instance metadata endpoint:
+
+```bash
+# Check the cert-manager deployment for OCI config
+kubectl get deployment cert-manager -n cert-manager -o yaml | grep -i "oci\|instance\|workload"
+```
+
+**Auth method comparison:**
+
+| Method | Scope | Risk |
+|--------|-------|------|
+| OKE Workload Identity | ServiceAccount-bound (pod-level) | Correct — minimum scope |
+| Instance Principal | Node-level (all pods on node) | HIGH — any pod can issue certs |
+| User auth (API key) | User credentials in secret | HIGH — credential rotation required |
+
+### Step 5 — Review IAM policy
+
+Retrieve the IAM policy for cert-manager:
+
+```bash
+oci iam policy list --compartment-id <compartment-id> --all \
+  --query "data[?contains(statements[0], 'certificate-authority')]"
+```
+
+Minimum required policy statement:
+
+```
+Allow dynamic-group CertManagerDynamicGroup to use certificate-authorities
+  in compartment <compartment-name>
+  where request.permission='CREATE_CERTIFICATE_REQUEST'
+```
+
+**Flag as HIGH if the policy includes any of:**
+- `manage certificate-authorities` (grants delete, update, disable, schedule-deletion)
+- `manage certificates` without compartment scoping (affects all certs)
+- Wildcard resources or compartment `tenancy` instead of scoped compartment
+
+Additional permissions needed for cert-manager to retrieve issued certs:
+
+```
+Allow dynamic-group CertManagerDynamicGroup to read certificates
+  in compartment <compartment-name>
+```
+
+### Step 6 — Check OCSP reachability
+
+The OCI OCSP endpoint is `ocsp.pki.oraclecloud.com`. Verify reachability from OKE worker nodes:
+
+```bash
+# From within an OKE node or debug pod
+curl -sv https://ocsp.pki.oraclecloud.com/
+```
+
+For OKE clusters with no internet gateway or restrictive security group rules:
+
+```bash
+# Check security list / NSG rules for outbound HTTPS to OCI OCSP
+oci network security-list list --vcn-id <vcn-id> \
+  --query "data[].egress-security-rules[]"
+```
+
+OCI OCSP endpoints use HTTPS (443). Ensure the OKE worker node security group allows outbound TCP/443 to OCI service endpoints. Using a Service Gateway with the `OCI Services in Oracle Services Network` service covers OCI PKI endpoints.
+
+**Flags:**
+- No Service Gateway configured and no internet gateway (OCI OCSP unreachable) — MEDIUM
+- Security group blocks TCP/443 outbound to OCI service network — MEDIUM
+
+### Step 7 — Review certificate version count
+
+```bash
+oci certs-mgmt certificate list-certificate-versions \
+  --certificate-id <cert-ocid> \
+  --all \
+  --query "length(data)"
+```
+
+Each cert rotation by cert-manager creates a new version. Old versions should be cleaned up to avoid high version counts.
+
+**Flags:**
+- Certificate version count > 10 — LOW (storage cost and management overhead)
+- No automated cleanup of old versions configured — LOW
+
+---
+
+## Output Format
+
+### Finding: `<short title>`
+
+| Field | Value |
+|-------|-------|
+| Severity | CRITICAL / HIGH / MEDIUM / LOW |
+| Resource | CA OCID, IAM policy name, or cert name |
+| Evidence | documentation-based / live evidence / inference |
+| Description | What is wrong and its impact on PKI trust |
+| Remediation | OCI CLI command, IAM policy statement, or configuration change |
+
+---
+
+### Overall OCI PKI Trust Posture
+
+| Category | Status |
+|----------|--------|
+| CA hierarchy (subordinate only) | PASS / FAIL |
+| Issuance rules (validity caps) | PASS / FAIL |
+| Authentication method (Workload Identity) | PASS / FAIL |
+| IAM policy scope (minimum permissions) | PASS / FAIL |
+| OCSP reachability | PASS / FAIL |
+| Certificate version lifecycle | PASS / FAIL |
+
+**Verdict:** TRUSTED / UNTRUSTED / CONDITIONAL (list conditions)

package/skills/oci/oci-live-autonomous-db-lifecycle-guard/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: oci-live-autonomous-db-lifecycle-guard
+description: Guard Autonomous Database lifecycle changes — scale, start, stop, clone, terminate — with protection-tag enforcement, backup verification, and connection-string impact analysis before any mutation.
+metadata:
+  author: "github: Raishin"
+  version: "0.1.0"
+---
+
+# OCI Live Autonomous DB Lifecycle Guard
+
+## Purpose
+
+Act as the guarded live OCI operator for oci-live-autonomous-db-lifecycle-guard work. Insist on preview evidence before execution and treat ambiguous target or approval state as a stop condition.
+
+## When to use
+
+Use this skill when:
+
+- an Autonomous Database must be scaled, started, stopped, cloned, or terminated against a live OCI environment
+- a protection tag must be audited before a lifecycle operation that could cause data loss or outage
+- an Autonomous Database backup or wallet must be confirmed before a scale or clone operation
+
+## Lean operating rules
+
+- Prefer OCI CLI (`oci`) official documentation when available; fall back to Oracle Cloud docs and sanitized user evidence.
+- Do not execute a live OCI change until tenancy, compartment, active principal, and resource ownership are explicit.
+- Prefer plan, detect-drift, inspect, read, describe, and rollback evidence before execution.
+- If the request skips preview or rollback design, push back.
+- Never print secrets, API keys, tenancy OCIDs, private key contents, or raw config values. Summarize sanitized evidence only.
+- Load references only when needed.
+
+## References
+
+Load these only when needed:
+
+- [Preflight commands](references/preflight-commands.md) — OCI CLI commands to run before any mutation.
+- [Rollback playbook](references/rollback-playbook.md) — concrete rollback steps for this service.
+- [Permission model](references/permission-model.md) — OCI IAM policy statements and dynamic group guidance.
+- [Official sources](references/official-sources.md) — authoritative OCI documentation links.
+
+## Response minimum
+
+Return, at minimum:
+
+- confirmed tenancy, compartment, and active principal
+- preflight evidence (plan output, drift result, inspect/read, health check)
+- approval status for the proposed mutation
+- rollback posture or explicit statement of what cannot be rolled back
+- post-action verification steps or refusal reason

package/skills/oci/oci-live-autonomous-db-lifecycle-guard/metadata.json

@@ -0,0 +1,27 @@
+{
+  "id": "oci-live-autonomous-db-lifecycle-guard",
+  "name": "OCI Live Autonomous DB Lifecycle Guard",
+  "type": "skill",
+  "provider": "oci",
+  "harnesses": [
+    "codex",
+    "claude-code",
+    "cursor",
+    "gemini",
+    "kiro",
+    "other"
+  ],
+  "summary": "Guard Autonomous Database lifecycle changes \u2014 scale, start, stop, clone, terminate \u2014 with protection-tag enforcement, backup verification, and connection-string impact analysis before any mutation.",
+  "source_type": "original",
+  "official_docs": [
+    "https://docs.oracle.com/en-us/iaas/Content/Database/Tasks/adbscaling.htm",
+    "https://docs.oracle.com/en-us/iaas/Content/Database/Tasks/adbstopstart.htm",
+    "https://docs.oracle.com/en-us/iaas/Content/Database/Tasks/adbcloning.htm",
+    "https://docs.oracle.com/en-us/iaas/Content/Database/Tasks/adbbackingup.htm"
+  ],
+  "security_notes": "ADB termination is permanent \u2014 the database and all backups are deleted. Always verify protection tags before any terminate operation. ADB storage scale-up cannot be reversed. Termination blocked by defined-tag protection requires explicit tag removal approval.",
+  "last_verified": "2026-04-30",
+  "path": "skills/oci/oci-live-autonomous-db-lifecycle-guard",
+  "author": "github: Raishin",
+  "version": "0.1.0"
+}

package/skills/oci/oci-live-autonomous-db-lifecycle-guard/references/official-sources.md

@@ -0,0 +1,13 @@
+# Official Sources: OCI Live Autonomous DB Lifecycle Guard
+
+## OCI Autonomous Database
+
+- https://docs.oracle.com/en-us/iaas/Content/Database/Concepts/adboverview.htm
+- https://docs.oracle.com/en-us/iaas/Content/Database/Tasks/adbmanaging.htm
+- https://docs.oracle.com/en-us/iaas/Content/Database/Tasks/adbbackingup.htm
+- https://docs.oracle.com/en-us/iaas/Content/Database/Tasks/adbcloning.htm
+
+## Source-grounding rule
+
+Use official Oracle Cloud Infrastructure documentation as the source of truth for ADB behavior.
+Lifecycle state transitions and backup retention windows must be verified from current OCI docs.

package/skills/oci/oci-live-autonomous-db-lifecycle-guard/references/permission-model.md

@@ -0,0 +1,49 @@
+# Permission Model: OCI Live Autonomous DB Lifecycle Guard
+
+## 3-tier separation
+
+| Tier | Group | Verb | Scope |
+|------|-------|------|-------|
+| Audit | `<adb-auditors>` | inspect / read | `<prod-db-compartment>` |
+| Operator | `<adb-operators>` | use | `<prod-db-compartment>` |
+| Admin | `<adb-admins>` | manage + tag condition | `<prod-db-compartment>` |
+
+## Baseline read (no mutation)
+
+```
+Allow group <adb-auditors> to inspect autonomous-databases in compartment <prod-db-compartment>
+Allow group <adb-auditors> to read autonomous-databases in compartment <prod-db-compartment>
+Allow group <adb-auditors> to read autonomous-database-backups in compartment <prod-db-compartment>
+```
+
+## Operator — start, stop, scale (use verb, no terminate/clone)
+
+```
+Allow group <adb-operators> to use autonomous-databases in compartment <prod-db-compartment>
+```
+
+With `use`: start, stop, scale CPU/storage, generate wallet.
+Cannot: terminate, clone, change network-access type.
+
+## Admin — clone and terminate (manage + tag condition)
+
+```
+Allow group <adb-admins> to manage autonomous-databases in compartment <prod-db-compartment>
+  where target.resource.tag.Operations.Lifecycle.value != 'protected'
+```
+
+The `Operations.Lifecycle = protected` tag must be set in a **protected tag namespace** on all
+production ADBs. Only tag-namespace admins can remove the tag.
+
+> **IRREVERSIBILITY WARNING**
+> - **Termination** is permanent. OCI does not recover terminated ADB instances.
+> - **Storage scale-up** is a one-way door — storage can only grow, never shrink.
+> - Both operations require dual-sign-off and a confirmed maintenance window.
+
+## Do not use
+
+```
+# FORBIDDEN
+Allow group <adb-operators> to manage autonomous-databases in tenancy
+Allow any-user to use autonomous-databases in compartment prod-db
+```

package/skills/oci/oci-live-autonomous-db-lifecycle-guard/references/preflight-commands.md

@@ -0,0 +1,58 @@
+# Preflight Commands: OCI Live Autonomous DB Lifecycle Guard
+
+Run these before any ADB lifecycle mutation. Paste sanitized output as evidence.
+
+## 1. Confirm identity and tenancy
+
+```bash
+oci iam region list --query "data[0]" 2>/dev/null || true
+oci iam user get --user-id $(oci iam user list --query "data[0].id" --raw-output) \
+  --query "data.{name:name,id:id}" 2>/dev/null
+# Or check OCI config profile
+cat ~/.oci/config | grep -E "^(user|tenancy|region|fingerprint)"
+```
+
+## 2. Get current ADB state
+
+```bash
+oci db autonomous-database get \
+  --autonomous-database-id <ADB_OCID> \
+  --query "data.{displayName:\"display-name\",lifecycleState:\"lifecycle-state\",ocpuCount:\"ocpu-count\",dataStorageSizeInTBs:\"data-storage-size-in-tbs\",freeformTags:\"freeform-tags\",definedTags:\"defined-tags\"}"
+```
+
+## 3. Verify protection tag is set (before any manage-verb operation)
+
+```bash
+oci db autonomous-database get \
+  --autonomous-database-id <ADB_OCID> \
+  --query "data.\"defined-tags\".Operations.Lifecycle"
+# Must return "protected" on production ADBs
+```
+
+## 4. Confirm recent backup exists
+
+```bash
+oci db autonomous-database-backup list \
+  --autonomous-database-id <ADB_OCID> \
+  --sort-by TIMECREATED \
+  --sort-order DESC \
+  --limit 3 \
+  --query "data[].{displayName:\"display-name\",lifecycleState:\"lifecycle-state\",timeStarted:\"time-started\",isAutomatic:\"is-automatic\"}"
+```
+
+## 5. Check wallet and connection strings (before scale/clone)
+
+```bash
+oci db autonomous-database get \
+  --autonomous-database-id <ADB_OCID> \
+  --query "data.{connectionStrings:\"connection-strings\",connectionUrls:\"connection-urls\"}"
+```
+
+## 6. Verify no in-flight operations
+
+```bash
+oci db autonomous-database get \
+  --autonomous-database-id <ADB_OCID> \
+  --query "data.{lifecycleState:\"lifecycle-state\",lifecycleDetails:\"lifecycle-details\"}"
+# lifecycleState must be AVAILABLE before any mutation
+```