Skip to main content

Questions Ask ZARA Can Answer

Ask ZARA is designed to help developers, architects, and auditors explore the ZAYAZ platform by reasoning across documentation, registries, schemas, and system metadata.

The assistant combines semantic search with architecture-aware retrieval to answer questions that normally require reading multiple specifications.

Below are examples of questions Ask ZARA can help answer.

1. Architecture Understanding​

Ask ZARA can explain how major parts of the system work.

Examples:

  • “Explain the purpose of the PEF-ME engine.”
  • “How does the SEM module extrapolate missing ESG data?”
  • “What is the role of the Compliance Surveillance Engine (COSE)?”
  • “Describe the architecture of the ZAYAZ Computation Hub.”

These questions typically combine information from:

  • engine specifications
  • system architecture documentation
  • module descriptions

2. Dependency & Impact Analysis​

Ask ZARA can trace relationships between signals, engines, tables, and modules.

Examples:

  • “Which engines depend on this signal?”
  • “What modules reference this table?”
  • “What breaks if we modify this API contract?”
  • “Which downstream systems use this schema field?”

These answers rely on indexed metadata such as:

  • used_by_engines
  • table_relationships
  • classification
  • link_group

This allows Ask ZARA to reconstruct architecture paths like:

engine → signal → table → schema → downstream engine

3. Implementation Guidance​

Ask ZARA can help developers understand how to implement or extend parts of the platform.

Examples:

  • “Show the API contract for the transition ROI calculator.”
  • “What parameters does the GHG aggregation engine require?”
  • “Where is the schema for signal_registry defined?”
  • “Which files implement this engine?”

These answers often include links to:

  • code snippets
  • API contracts
  • schema definitions
  • engine specifications

4. Data & Schema Exploration​

Ask ZARA can help explore data structures and registries used by the platform.

Examples:

  • “What fields exist in the signal registry?”
  • “Which tables reference dim_suppliers?”
  • “Explain the relationship between these tables.”
  • “Which schemas are used by the GHG aggregation engine?”

5. Specification Navigation​

Ask ZARA can guide readers through complex documentation.

Examples:

  • “Where is the specification for the Carbon Passport system?”
  • “Show the documentation describing API contracts.”
  • “Which docs explain the ZADIF dispatcher?”
  • “Summarize the purpose of the Global Disclosure Ontology.”

6. Compliance & Risk Interpretation​

Because the ZAYAZ platform integrates regulatory frameworks, Ask ZARA can also explain compliance logic.

Examples:

  • “How does the Risk Intelligence Framework validate ESG data?”
  • “Which engines are responsible for regulatory monitoring?”
  • “Explain how ZAYAZ supports CSRD reporting.”

7. Tip​

Ask ZARA works best when questions include specific architecture elements, such as:

  • engine names
  • signals
  • tables
  • modules
  • specifications

For example:

Good question:

“Which engines depend on the ghg_scope3_signal?”

Less effective question:

“Tell me about the system.”

8. When Ask ZARA May Be Wrong.​

Ask ZARA is designed to assist developers and architects in exploring the ZAYAZ platform. While it combines semantic retrieval with architecture-aware reasoning, it should be treated as a documentation assistant, not a source of authoritative system state.

Users should verify important conclusions against the underlying specifications and source files.

8.1. Incomplete Retrieval​

Ask ZARA answers questions based on the indexed corpus stored in the search index.

If relevant information is:

  • not indexed,
  • newly added but not yet re-indexed, or
  • located in files outside the documentation corpus,

the answer may omit important details.

Typical symptoms:

  • a dependency appears to be missing
  • only part of a subsystem is described
  • a referenced component is not mentioned

When this happens, consult the underlying documentation or repository files directly.

Note: Ask ZARA is schedules to re-indexed once every 24 hours, which may exclude new documentation from queries.

8.2. Ambiguous Architecture Terms​

Some architecture terms appear in multiple contexts within the platform.

Examples may include:

  • signals with similar names
  • tables reused across modules
  • engines with related responsibilities

If a question does not include enough context, Ask ZARA may retrieve information from the wrong subsystem.

Example:

“Explain the aggregation engine”

The system may return results for several different engines that perform aggregation tasks.


More specific questions improve accuracy:

“Explain the GHG aggregation calculator micro-engine.”

8.3. Partial Dependency Analysis​

Ask ZARA can trace many architecture relationships using indexed metadata such as:

  • used_by_engines
  • table_relationships
  • classification
  • link_group

However, not all dependencies are guaranteed to be captured in these registries.

Dependencies defined only in:

  • application code
  • runtime configuration
  • external services

may not be visible to the retrieval system.

For critical impact analysis, always confirm results with the system specifications.

8.4. Reasoning Errors​

Ask ZARA uses large language models to interpret retrieved information.

Although the model is guided by system prompts and citations, it may occasionally:

  • infer relationships that are not explicitly documented
  • misinterpret technical descriptions
  • over-generalize from similar components

For this reason, answers should be viewed as interpretations of documentation, not guaranteed architectural truth.

8.5. Outdated Information​

The ZAYAZ platform evolves continuously.

If the documentation index is not rebuilt after recent changes, Ask ZARA may return answers based on:

  • outdated specifications
  • previous versions of schemas
  • deprecated engine behavior

Regenerating the search index ensures the assistant reflects the most recent architecture.

Ask ZARA works best when used as a navigation and exploration tool.

Recommended uses include:

  • locating relevant documentation
  • understanding system architecture
  • discovering related engines, tables, or signals
  • summarizing complex specifications

For tasks such as:

  • production configuration decisions
  • compliance verification
  • schema migrations
  • system modifications

the underlying specifications and source files should always be consulted directly.

Summary​

Ask ZARA is designed to accelerate exploration of the ZAYAZ platform by combining semantic search with architecture-aware reasoning.

It should be treated as:

an intelligent guide to the documentation, not a replacement for the specifications themselves.



GitHub RepoRequest for Change (RFC)