From 70989ebc8c0976dddb36a67ae417287e72fff970 Mon Sep 17 00:00:00 2001
From: ftchvs <ftchvs@icloud.com>
Date: Mon, 25 May 2026 21:03:11 -0700
Subject: [PATCH] docs: add repo health baseline

---
 .github/ISSUE_TEMPLATE/bug_report.yml        | 28 +++++++++++++++++
 .github/ISSUE_TEMPLATE/workflow_proposal.yml | 33 ++++++++++++++++++++
 .github/workflows/validate.yml               | 21 +++++++++++++
 CODE_OF_CONDUCT.md                           | 32 +++++++++++++++++++
 package.json                                 |  1 +
 tests/aw.test.ts                             |  2 +-
 6 files changed, 116 insertions(+), 1 deletion(-)
 create mode 100644 .github/ISSUE_TEMPLATE/bug_report.yml
 create mode 100644 .github/ISSUE_TEMPLATE/workflow_proposal.yml
 create mode 100644 .github/workflows/validate.yml
 create mode 100644 CODE_OF_CONDUCT.md

diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
new file mode 100644
index 0000000..52c1ffc
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -0,0 +1,28 @@
+name: Bug report
+description: Report a problem with the CLI, schema, templates, or workflows.
+title: "[Bug]: "
+labels: ["bug"]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What happened?
+    validations:
+      required: true
+  - type: textarea
+    id: reproduce
+    attributes:
+      label: Reproduction
+      description: Steps, command, workflow file, or minimal synthetic example.
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+  - type: textarea
+    id: environment
+    attributes:
+      label: Environment
+      description: OS, Bun version, and command used.
diff --git a/.github/ISSUE_TEMPLATE/workflow_proposal.yml b/.github/ISSUE_TEMPLATE/workflow_proposal.yml
new file mode 100644
index 0000000..90851cc
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/workflow_proposal.yml
@@ -0,0 +1,33 @@
+name: Workflow proposal
+description: Propose a public-safe workflow, template, or operating pattern.
+title: "[Workflow]: "
+labels: ["workflow"]
+body:
+  - type: input
+    id: use-case
+    attributes:
+      label: Use case
+      description: What repeatable work should this workflow handle?
+    validations:
+      required: true
+  - type: textarea
+    id: artifact
+    attributes:
+      label: Output artifact
+      description: What durable artifact should the workflow produce?
+    validations:
+      required: true
+  - type: textarea
+    id: authority
+    attributes:
+      label: Authority and approval boundaries
+      description: What may the agent do, and what must require human approval?
+    validations:
+      required: true
+  - type: textarea
+    id: safety
+    attributes:
+      label: Public-safety notes
+      description: Confirm the proposal uses synthetic examples and no private data.
+    validations:
+      required: true
diff --git a/.github/workflows/validate.yml b/.github/workflows/validate.yml
new file mode 100644
index 0000000..c2a3b1f
--- /dev/null
+++ b/.github/workflows/validate.yml
@@ -0,0 +1,21 @@
+name: Validate
+
+on:
+  pull_request:
+  push:
+    branches: [main]
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+      - name: Install dependencies
+        run: bun install
+      - name: Validate workflows and publication safety
+        run: bun run validate
diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md
new file mode 100644
index 0000000..ad6c932
--- /dev/null
+++ b/CODE_OF_CONDUCT.md
@@ -0,0 +1,32 @@
+# Code of Conduct
+
+## Our pledge
+
+We want `agentic-workflows` to be useful, clear, and safe for people building
+human-controlled AI operating patterns. Contributors are expected to participate
+with respect, care, and practical focus.
+
+## Expected behavior
+
+- Use welcoming and inclusive language.
+- Respect different levels of experience.
+- Give constructive feedback that improves the work.
+- Keep examples public-safe and synthetic.
+- Avoid publishing private operational details, secrets, or personal data.
+
+## Unacceptable behavior
+
+- Harassment, threats, insults, or discriminatory language.
+- Publishing someone else's private information.
+- Intentionally derailing discussions or reviews.
+- Submitting examples that expose real private systems, people, clients, or
+  credentials.
+
+## Enforcement
+
+Project maintainers may remove comments, close issues or pull requests, or block
+contributors whose behavior is harmful to the project or community.
+
+If you need to report a concern, open a private security advisory or contact the
+maintainer through the repository owner profile. Do not include secrets or
+private personal data in public issues.
diff --git a/package.json b/package.json
index e574d1c..03dd47f 100644
--- a/package.json
+++ b/package.json
@@ -2,6 +2,7 @@
   "name": "agentic-workflows",
   "version": "0.2.0",
   "private": false,
+  "license": "CC-BY-4.0",
   "type": "module",
   "bin": {
     "aw": "./cli/aw.ts"
diff --git a/tests/aw.test.ts b/tests/aw.test.ts
index 741bb6d..c15777e 100644
--- a/tests/aw.test.ts
+++ b/tests/aw.test.ts
@@ -143,7 +143,7 @@ test("publication-scan lists covered public repo artifacts", async () => {
   expect(result.stdout).toContain("package.json");
   expect(result.stdout).toContain("examples/growth-skill-evals/README.md");
   expect(result.stdout).toContain("workflows/growth-launch-readiness.workflow.yml");
-  expect(result.stdout).toContain("listed 70 publication file(s)");
+  expect(result.stdout).toContain("listed 76 publication file(s)");
 });
 
 test("check-skills rejects mismatched skill names", async () => {