Skip to content

GEMINI.md and new Indicator skill defition is added.#328

Merged
cinar merged 1 commit intomasterfrom
gemini
Feb 25, 2026
Merged

GEMINI.md and new Indicator skill defition is added.#328
cinar merged 1 commit intomasterfrom
gemini

Conversation

@cinar
Copy link
Owner

@cinar cinar commented Feb 25, 2026

Describe Request

GEMINI.md and new indicator skill definition is added.

Change Type

Code maintenance.

Summary by CodeRabbit

  • Documentation
    • Added comprehensive documentation files covering project architecture, package overviews, development standards, testing practices, and workflow guidelines for the indicator system and related modules.

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Feb 25, 2026

📝 Walkthrough

Walkthrough

A comprehensive documentation initiative adds eleven GEMINI.md files across the codebase, introducing standardized guides for package architectures, indicator development workflows, testing patterns, and utility references, without modifying any executable code.

Changes

Cohort / File(s) Summary
Core Project Documentation
GEMINI.md, .gemini/skills/add-indicator/SKILL.md
Root project overview with architecture, standards, and build commands; indicator development workflow guide covering categorization, streaming patterns, struct/factory requirements, method signatures, testing, and integration steps.
Package Architecture Guides
asset/GEMINI.md, backtest/GEMINI.md, helper/GEMINI.md, strategy/GEMINI.md
Documentation for asset data management (models, repositories, factories, storage types); backtest workflow and reporting components; helper utilities (channels, math, stats, data functions); strategy package interfaces, combinators, and composition patterns.
Indicator Category Documentation
momentum/GEMINI.md, trend/GEMINI.md, valuation/GEMINI.md, volatility/GEMINI.md, volume/GEMINI.md
Category-specific guides for momentum oscillators, trend indicators with moving averages, valuation ratios, volatility bands and indicators, and volume price indicators; all reference consistent Compute pattern, generic over Number type, and CSV-based testing standards.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Poem

🐰 Documentation bundles, oh what a sight!
Eleven new guides to make the code right,
From helpers to strategies, each package aligned,
With patterns and tests all perfectly defined!
The garden of knowledge now flourishes bright! 🌿✨

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly identifies the main changes: addition of GEMINI.md documentation files and a new indicator skill definition across multiple directories.
Description check ✅ Passed The description follows the template with both required sections completed: a clear request description and the change type specified as code maintenance.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch gemini

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@codecov-commenter
Copy link

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 89.04%. Comparing base (bf76642) to head (6a9fb33).

❌ Your project status has failed because the head coverage (89.04%) is below the target coverage (90.00%). You can increase the head coverage or adjust the target coverage.

Additional details and impacted files
@@           Coverage Diff           @@
##           master     #328   +/-   ##
=======================================
  Coverage   89.04%   89.04%           
=======================================
  Files         207      207           
  Lines        5822     5822           
=======================================
  Hits         5184     5184           
  Misses        566      566           
  Partials       72       72           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🧹 Nitpick comments (1)
strategy/GEMINI.md (1)

15-21: Reduce future doc drift for embedded interface snippets.

Lines 15–21 duplicate API shape inline; consider adding a “source of truth” pointer near this block (or a docs-generation step) so the snippet stays aligned with real code as interfaces evolve.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@strategy/GEMINI.md` around lines 15 - 21, The embedded Strategy interface
snippet (Strategy[T helper.Number] with Compute, IdlePeriod, String) can drift
from the actual code; update GEMINI.md to reference the canonical source by
adding a "source of truth" pointer (e.g., a comment or link to the real
interface declaration) next to this block and/or replace the hardcoded snippet
with an include-generated snippet from the actual source file (the interface
definition containing Compute, IdlePeriod, String) via your docs build step so
the docs always reflect the real Strategy interface.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In @.gemini/skills/add-indicator/SKILL.md:
- Line 18: The example list under the valuation section currently shows generic
terms "FV, NPV"; replace those with the actual valuation indicator names used in
the valuation docs (e.g., PeRatio, PsRatio, DividendYield) so the snippet
matches the documented indicators and avoids contributor confusion—update the
line containing `valuation/: Asset valuation (FV, NPV, etc.)` to use the
documented examples and ensure wording and punctuation mirror the valuation
docs' examples.

In `@volume/GEMINI.md`:
- Line 7: The listing incorrectly categorizes "Adx" under Price-Volume; change
the entry so Price-Volume contains only volume-native indicators (e.g., keep
"Adi", "Cmfi", "Emv") and remove "Adx", and either (a) add "Adx" to the trend
indicators section (use the exact symbol "Adx") or (b) replace "Adx" in the
Price-Volume list with a true volume indicator such as "Obv" or "Vpt" to reflect
volume-native semantics; update any surrounding text to match the moved/replaced
symbol.

---

Nitpick comments:
In `@strategy/GEMINI.md`:
- Around line 15-21: The embedded Strategy interface snippet (Strategy[T
helper.Number] with Compute, IdlePeriod, String) can drift from the actual code;
update GEMINI.md to reference the canonical source by adding a "source of truth"
pointer (e.g., a comment or link to the real interface declaration) next to this
block and/or replace the hardcoded snippet with an include-generated snippet
from the actual source file (the interface definition containing Compute,
IdlePeriod, String) via your docs build step so the docs always reflect the real
Strategy interface.

ℹ️ Review info

Configuration used: defaults

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between bf76642 and 6a9fb33.

📒 Files selected for processing (11)
  • .gemini/skills/add-indicator/SKILL.md
  • GEMINI.md
  • asset/GEMINI.md
  • backtest/GEMINI.md
  • helper/GEMINI.md
  • momentum/GEMINI.md
  • strategy/GEMINI.md
  • trend/GEMINI.md
  • valuation/GEMINI.md
  • volatility/GEMINI.md
  • volume/GEMINI.md

- `momentum/`: Momentum indicators (RSI, Stochastic, etc.)
- `volatility/`: Volatility indicators (Bollinger Bands, ATR, etc.)
- `volume/`: Volume-based indicators (OBV, Chaikin Money Flow, etc.)
- `valuation/`: Asset valuation (FV, NPV, etc.)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Align valuation examples with package docs.

Using FV, NPV here conflicts with the valuation indicators documented in valuation/GEMINI.md (e.g., PeRatio, PsRatio, DividendYield). Aligning examples will reduce contributor confusion.

Suggested doc edit
-- `valuation/`: Asset valuation (FV, NPV, etc.)
+- `valuation/`: Valuation indicators (PeRatio, PsRatio, PbRatio, DividendYield, etc.)
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
- `valuation/`: Asset valuation (FV, NPV, etc.)
- `valuation/`: Valuation indicators (PeRatio, PsRatio, PbRatio, DividendYield, etc.)
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In @.gemini/skills/add-indicator/SKILL.md at line 18, The example list under the
valuation section currently shows generic terms "FV, NPV"; replace those with
the actual valuation indicator names used in the valuation docs (e.g., PeRatio,
PsRatio, DividendYield) so the snippet matches the documented indicators and
avoids contributor confusion—update the line containing `valuation/: Asset
valuation (FV, NPV, etc.)` to use the documented examples and ensure wording and
punctuation mirror the valuation docs' examples.


## Key Indicators

- **Price-Volume:** `Adi` (Accumulation Distribution Index), `Adx` (Average Directional Index), `Cmfi` (Chaikin Money Flow Index), `Emv` (Ease of Movement).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Correct indicator categorization for Adx.

Adx is typically a trend indicator, so listing it under Price-Volume is likely misleading. Please either move it to a trend context or replace it here with a volume-native item if that was intended.

Suggested doc edit
-- **Price-Volume:** `Adi` (Accumulation Distribution Index), `Adx` (Average Directional Index), `Cmfi` (Chaikin Money Flow Index), `Emv` (Ease of Movement).
+- **Price-Volume:** `Adi` (Accumulation Distribution Index), `Cmfi` (Chaikin Money Flow Index), `Emv` (Ease of Movement).
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@volume/GEMINI.md` at line 7, The listing incorrectly categorizes "Adx" under
Price-Volume; change the entry so Price-Volume contains only volume-native
indicators (e.g., keep "Adi", "Cmfi", "Emv") and remove "Adx", and either (a)
add "Adx" to the trend indicators section (use the exact symbol "Adx") or (b)
replace "Adx" in the Price-Volume list with a true volume indicator such as
"Obv" or "Vpt" to reflect volume-native semantics; update any surrounding text
to match the moved/replaced symbol.

@cinar cinar merged commit 855cb96 into master Feb 25, 2026
6 checks passed
@cinar cinar deleted the gemini branch February 25, 2026 06:16
@github-actions github-actions bot locked and limited conversation to collaborators Feb 25, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants