@geraldmaron/construct 1.0.3 → 1.0.4

package/templates/docs/research-brief.md

@@ -2,28 +2,82 @@
 
 - **Date**: {YYYY-MM-DD}
 - **Author**: {name}
+- **Domain**: {ai-tools | developer-tools | security | market | cloud-api | regulatory | academic | other}
 - **Status**: in-progress | complete
+- **Recency baseline**: Sources from {YYYY} and later preferred; oldest source used: {YYYY-MM-DD}
 
 ## Question
-<!-- The specific, falsifiable question this research is trying to answer. One sentence. -->
+
+<!-- One specific, falsifiable question this research must answer. Not a topic — a question with a determinate answer. -->
 
 ## Method
-<!-- How the question was investigated. Start order, queries run, internal paths checked, experiments performed, and systems consulted. Enough detail that another person could reproduce it. -->
+
+<!-- How the question was investigated:
+  - Domain starting point used (arXiv, NVD, Stack Overflow Survey, vendor docs, etc.)
+  - Date filter applied (search from YYYY-first)
+  - Internal paths checked (.cx/research/, .cx/knowledge/, ADRs, etc.)
+  - Search terms and queries run
+  - Systems and indexes consulted
+  - Inclusion/exclusion decisions
+  Enough detail that another person could reproduce it. -->
 
 ## Sources
-<!-- For each source record: title/path, source class (internal/primary/secondary/tertiary), version or revision if relevant, and publication/access date. Separate primary from secondary. Note where sources disagree. -->
+
+| Title / Path | Class | Date | URL | Verified | Relevance |
+|---|---|---|---|---|---|
+| {source title or file path} | primary / secondary / tertiary | {YYYY-MM-DD} | {URL or path} | yes / no / n/a | {one-line} |
+
+<!-- Class definitions:
+  - primary: peer-reviewed papers, official docs at exact version, raw source code, standards, company announcements, SEC filings
+  - secondary: changelogs, migration guides, tracked issues, maintainer posts, conference talks by authors
+  - tertiary: blog posts, forums, Q&A, analyst summaries — for discovery only, never as evidence
+  Mark Verified = yes only after fetching the URL and confirming content matches. -->
 
 ## Findings
-<!-- What the evidence says. Separate observation from inference. Label each finding with its confidence level and cite the supporting source(s). -->
 
-## Confidence
-<!-- Per finding: high / medium / low, and why. Name the biggest unknowns. -->
+<!-- For each finding, state separately:
+  - Observation: what the source(s) actually say — direct, traceable
+  - Inference: what is concluded from the observation — labeled as inference
+  - Confidence: high / medium / low, with a one-line reason
+  - Sources: reference the Source table row(s) -->
+
+### Finding 1 — {short label}
+
+**Observation**: <!-- what the sources say -->
+**Inference**: <!-- what is concluded — labeled as inference -->
+**Confidence**: high / medium / low — {reason}
+**Sources**: {source title(s) from table}
+
+### Finding N — {short label}
+
+<!-- repeat as needed -->
+
+## Counter-evidence
+
+<!-- The strongest finding that contradicts or complicates the conclusion. How it was addressed. If no counter-evidence was found, state that and note whether it was actively searched for. -->
+
+## Confidence summary
+
+<!-- Overall confidence across all findings. Key uncertainties. What would most change the conclusion. -->
+
+## Gaps
+
+<!-- What this research did not resolve. For each gap: what evidence is missing and what would be needed to fill it. -->
 
 ## Implications
-<!-- What decisions this research enables or blocks. Who should act on it. -->
+
+<!-- What decisions this research enables or blocks. Who should act on it and in what timeframe. -->
+
+## Recommendation
+
+<!-- What the evidence supports. State the evidence threshold at which this recommendation would flip. -->
 
 ## Open questions
-<!-- What this research did not resolve. What would be needed to answer each. -->
+
+<!-- Remaining questions scoped out of this brief. Suitable for a follow-up research task or a handoff. -->
 
 ## References
-<!-- Full citation list. Include URLs, document paths, versions, and dates. -->
+
+<!-- Full citation list. Format: Author(s). (Year). Title. Venue/Source. Retrieved from URL.
+  Include: author(s) or org, year, title, publication venue, URL, access date for web sources.
+  Mark any URL that was not verified as [unverified]. -->

package/templates/docs/strategy.md

@@ -0,0 +1,36 @@
+---
+title: Product Strategy
+updated: YYYY-MM-DD
+horizon: "6–12 months"
+---
+
+<!--
+templates/docs/strategy.md — Template for product strategy documents.
+Use for both user-product strategy and Construct's own strategy (.cx/strategy.md).
+Canonical store: ~/.cx/strategy.md (user-global) or .cx/strategy.md (project-local, committed).
+Owning workflow: skills/docs/strategy-workflow.md.
+-->
+
+## Vision
+<!-- 1–3 sentences. Where are we going in 3–5 years? -->
+
+## Bets
+<!-- Explicit choices. Each bet: what we're doing and why. -->
+- **Bet 1**: …
+- **Bet 2**: …
+
+## Non-bets
+<!-- What we are explicitly NOT doing, and why. This section prevents strategy drift. -->
+- **Not doing**: … **Because**: …
+
+## Time Horizon
+<!-- Current cycle focus. What must be true 6–12 months from now? -->
+
+## North Star Metric
+<!-- Single measurable outcome. Format: Metric / Baseline / Target / Owner -->
+
+## Competitive Positioning
+<!-- How we differentiate. 2–4 sentences. -->
+
+## Open Bets
+<!-- Decisions not yet made. Clarify and move to Bets or Non-bets. -->

package/templates/homebrew/construct.rb

@@ -2,13 +2,13 @@
 #
 # Authoritative copy lives in the construct repo at templates/homebrew/
 # construct.rb. The tap repo (geraldmaron/homebrew-construct) carries the
-# active formula at Formula/construct.rb and is updated by the release
-# workflow's Homebrew bump step on every tag push.
+# active formula at Formula/construct.rb.
 #
-# When the release pipeline fires for `vX.Y.Z`, dawidd6/action-homebrew-bump-
-# formula rewrites the url + sha256 fields for each platform from the
-# matching GitHub Release asset. The placeholder SHAs below are only used
-# when seeding the tap by hand the first time.
+# The release workflow's `homebrew` job regenerates Formula/construct.rb from
+# scratch on every `v*` tag push — it downloads sha256 sidecars from the
+# GitHub Release, fills in the version and per-platform URLs/SHAs, and pushes
+# directly to the tap. The placeholder SHAs below are only used when seeding
+# the tap by hand the first time (see docs/maintenance/homebrew-tap.md).
 class Construct < Formula
   desc "Deployable AI R&D operating system for coding agents — runs locally or for teams"
   homepage "https://github.com/geraldmaron/construct"