Actionist Knowledge Docs
Generated knowledge spine · knowledge/04-OPEN-QUESTIONS.md

04 · Open questions

Unresolved first-principles questions and the questions that should not restart a breadth loop.

Generated from knowledge/04-OPEN-QUESTIONS.md · regenerate with node site/system-map/scripts/generate-docs.mjs

Open first-principles questions

Problem and market

  1. Which single client outcome has the strongest combination of pain, willingness to pay, repeatability and reusable supply?
  2. Are the 17 industries the correct market partitions, or should selection begin from workflow archetypes independent of industry?
  3. Which industry differences materially change software architecture rather than language and configuration?
  4. What evidence would make us kill the semi-custom assembly thesis and build focused vertical products conventionally?

Capability and reuse

  1. What is the minimum semantic CapabilityContract that works for a service, embedded module and extracted package?
  2. Can one source yield several capabilities and packaging variants without identity confusion?
  3. What objective signals predict extraction/adaptation effort?
  4. At what point is transplantation cheaper than maintaining an adapter to upstream?
  5. Which donor concerns can be standardized through host adapters: branding, onboarding, settings, navigation, identity, billing, notifications and audit?
  6. How do we represent a complete application template without making it an indivisible monolith?

Data plane

  1. What state classes do the first 100 high-value capabilities actually require?
  2. What operations must the typed data port support: CRUD, transactions, subscriptions, bulk operations, search, files, analytics, schema introspection?
  3. Can owned Postgres resources and donor-native resources participate in one product workflow without hidden dual writes?
  4. When are events/read models sufficient, and when is synchronous cross-system consistency required?
  5. Should each client have one database, one schema, separate service stores or a hybrid?
  6. What is the migration and rollback model for an assembled application release?

Identity, settings and host absorption

  1. What is the canonical Actionist identity/session contract?
  2. How does a mature donor accept host identity without retaining reachable donor signup/login flows?
  3. Which settings are global, tenant, application, capability and user scoped?
  4. Can settings/navigation/onboarding surfaces be declared and remounted, or will each donor need bespoke surgery?
  5. How are feature permissions and external-action approvals represented consistently?

Connectors

  1. What is the canonical provider/action/trigger schema?
  2. Which providers require scripted setup beyond declarative schemas?
  3. How does Actionist own tenant connection storage while reusing external catalogues and OAuth engines?
  4. What is the idempotency, retry, rate-limit and receipt contract for side effects?
  5. When should browser automation be a connector runtime rather than a separate application feature?

UI and product composition

  1. What are the reusable levels: token, primitive, component, pattern, page, workflow and shell?
  2. How should 8,515 UI identities be deduplicated and scored by visual/interaction quality?
  3. Can design-token adaptation preserve donor UI quality without flattening every product into one generic aesthetic?
  4. Is user preference selection through galleries measurably better than chat descriptions?
  5. Which shell best serves case/workflow, portal, CRM, support and operations archetypes?
  6. How much donor UI should remain intact versus be rebuilt using Actionist components?

Composition and agents

  1. Which compatibility constraints are mechanical before source execution?
  2. What information makes the solver return UNDERDETERMINED, and which domain must supply it?
  3. What portion of adaptation can be represented as repeatable transforms?
  4. Which model class is required for source understanding, planning, adaptation and verification?
  5. Does plan-then-fill outperform direct code generation on first-pass workflow success, tokens and repair loops?
  6. How should the system choose between a complete donor service and several smaller blocks?

Runtime and operations

  1. Which runtime profiles are required for v1: package, microfrontend, iframe, sidecar, service, worker, cron?
  2. What should be rented versus operated for sandbox previews and deployment?
  3. How are runtime health, logs, versions and failures attributed to individual capabilities?
  4. Can one capability be upgraded or rolled back independently without invalidating the application composition?
  5. What is the minimal local/preview environment that faithfully predicts production?

Evidence and learning

  1. What does “quality” mean per capability kind: correctness, UX, maintainability, performance, adaptability, observability or production history?
  2. Which isolated receipts predict whole-workflow success?
  3. How do production incidents and client outcomes update asset rankings?
  4. What are the denominators for build success, maintenance burden and client value?
  5. What is the cost per accepted application, per workflow and per maintained client?
  6. Which research counters are structurally complete but semantically shallow?
  7. Where is the authoritative 1.3M/850k/80k corpus, and what is actually indexed?

Questions that should not consume another broad research loop yet

  • “Can we find more repositories?” Almost certainly yes; that does not test reuse.
  • “Can we list more Lovable competitors?” Yes; the current bottleneck is evidence depth and architecture, not names.
  • “Can we create more industry×repository rows?” Yes; earlier waves proved count growth can hide identity and evidence gaps.
  • “Which database brand wins universally?” No universal winner exists without workload classes and ownership constraints.
  • “Can an agent automate all of this?” The useful question is which decisions can be made mechanically, which can be model-assisted and which require accountable product judgment.

Canonical source remains knowledge/04-OPEN-QUESTIONS.md. This HTML is a generated projection; edit the source, then run generate-docs.mjs.