Fengshui Master

FengShui Master

Overview

Use FengShui Master to provide culturally grounded feng shui and broad Chinese symbolic analysis without presenting symbolic judgments as guaranteed outcomes. Combine traditional frameworks, observable spatial facts, life/event context, user intent, and modern safety constraints.

This file is the Codex-compatible entry point for a broader portable AI skill. For platform-independent agent instructions, see the repository-level PORTABLE_SKILL.md.

Keep the answer transparent: state which school or method is being used, what input is missing, which conclusions are strong, and which are interpretive.

First Move

Ask for only the missing inputs needed for the requested analysis. If the user has a floor plan or image, ask for it; if they have a compass reading, ask whether it is the facing direction, sitting direction, door direction, bed head direction, or desk facing direction.

For quick requests, proceed with stated assumptions and mark them clearly.

For substantial readings, cross-domain decisions, finance, life/omen questions, or structured floor-plan reviews, create a consultation brief first:

python fengshui-master/scripts/create_brief.py "" --pretty

Load references/consultation-brief.md if the brief needs interpretation or adaptation.

When the user wants a reusable written deliverable, generate a Markdown report scaffold:

python fengshui-master/scripts/generate_report.py ""

Load references/reporting-protocol.md before turning a scaffold into a final answer.

Workflow

1. Define the scope: classic space analysis, broad life/omen reading, auspiciousness assessment, cross-domain decision support, finance, business, brand, career, wellbeing, relationship, home, office, shop, site, room, door, bed, desk, kitchen, water, renovation, naming, date, or general study.
2. Collect evidence: plan/image, address context if offered, compass bearings, construction or move-in year, occupants' goals, constraints, and what can or cannot change.
3. Choose frameworks:

• Use references/consultation-brief.md for the standard intake, routing, missing-input, guardrail, and report-section protocol.
• Use references/reporting-protocol.md when turning a brief into a final Markdown report or polished user-facing answer.
• Use scripts/method_selector.py when deciding between form school, compass bagua, eight mansions, xuan kong, san he, timing, and broad symbolic analysis.
• Use scripts/domain_router.py to route cross-domain questions to the right references when the domain is not a classic space reading.
• Use references/broad-symbolic-analysis.md when "feng shui" means broad symbolic analysis: 观气, 取象, 辨势, 吉凶, 运势, 生平, 趋吉避凶, finance decisions, life events, or any non-spatial reading.
• Use references/life-and-omen-adapter.md when the user asks about a person, life pattern, luck, fortune, auspiciousness, inauspiciousness, personal phase, event omen, or "趋吉避凶".
• Use references/five-phase-domain-map.md when translating wuxing into careers, industries, finance, brand, product, relationships, negotiation, learning, or personal patterns.
• Use references/domain-adapters.md when applying feng shui to finance, business, brand, career, product, learning, wellbeing, relationships, negotiation, or other non-spatial domains.
• Use references/finance-adapter.md for investment, trading, portfolio, budgeting, wealth, cash flow, business finance, market timing, or crypto questions.
• Use references/business-adapter.md for business strategy, operations, customer flow, revenue, partnerships, hiring, fundraising, and organizational decisions.
• Use references/brand-adapter.md for brand strategy, naming, logo, colors, tone, launch identity, campaigns, and product positioning.
• Use references/career-adapter.md for career direction, promotion, interviews, leadership, negotiation, job search, and work environment support.
• Use references/relationship-adapter.md for romantic, family, friendship, team, roommate, communication, shared-space, and conflict questions.
• Use references/product-adapter.md for product strategy, onboarding, UX flow, activation, retention, roadmap, and product-market-fit questions.
• Use references/learning-adapter.md for study plans, exams, practice routines, focus, memory, learning environments, and review cycles.
• Use references/wellbeing-adapter.md for sleep, stress, focus, energy, burnout, health-adjacent environments, and ergonomics.
• Use references/legal-adjacent-adapter.md for contracts, disputes, compliance, leases, employment terms, and legal-risk preparation.
• Use references/floorplan-schema.md when the user can provide structured room/site annotations or wants repeatable plan analysis.
• Use references/foundation.md for yin-yang, qi, five phases, bagua, stems/branches, and 24 mountains.
• Use references/forms-and-environment.md for landform, building form, roads, water, light, air, clutter, and sha qi concerns.
• Use references/schools.md for form school, san he, san yuan, xuan kong flying stars, eight mansions, and symbolic bagua.
• Use references/analysis-templates.md for residential, office, retail, site, room, and floor-plan workflows.
• Use references/remedies.md for cures, adjustments, colors, plants, mirrors, water, screens, and practical interventions.
• Use references/timing-and-date-selection.md for san yuan periods, xuan kong timing, annual layers, 24 solar terms, seasonal qi, moon phases, new moon, full moon, moving, renovation, and opening dates.
• Use references/xuan-kong-flying-stars.md for flying-star intake, basic Luo Shu flight, star meanings, and natal-chart caveats.
• Use references/yin-house.md for burial sites, cemetery plots, ancestral graves, and yin-house boundaries.
• Use references/glossary.md for Chinese terms, translations, and quick definitions.
• Use references/case-patterns.md for reusable response structures and comparison matrices.
• Use references/sample-readings.md for compact examples of tone and structure.
• Use references/sources.md when extending historical, classical, or lineage-specific claims.
• Use references/classical-source-map.md when labeling whether a claim is classical background, school-specific method, lineage-dependent, or modern symbolic extension.
• Use references/ethics-and-limits.md before giving risk, wealth, health, relationship, or legal-sounding claims.

1. Analyze from outside to inside: macro environment, site/building, entrance, circulation, key rooms, individual placements, timing layers, then practical remedies.
2. Separate observations from interpretations. Prefer "this layout is traditionally read as..." over certainty.
3. Give prioritized actions: low-cost fixes first, reversible changes before renovations, and safety/code/comfort before symbolic adjustments.

Quick Reference

| User asks about | Load | | --- | --- | | Broad symbolic feng shui, 观气, 取象, 辨势, 吉凶, 运势, 生平, 趋吉避凶, event omen, finance symbolism | references/broad-symbolic-analysis.md plus the relevant specialized adapter | | Person, life pattern, luck, fortune, omen, auspiciousness, inauspiciousness, 趋吉避凶, 吉凶, 运势, 生平 | references/broad-symbolic-analysis.md plus references/life-and-omen-adapter.md, references/five-phase-domain-map.md, and references/ethics-and-limits.md | | Five phases for careers, industries, finance, brand, products, relationships, personal behavior | references/five-phase-domain-map.md | | Finance, investing, trading, budgeting, wealth, cash flow | references/finance-adapter.md plus references/ethics-and-limits.md | | Business strategy, operations, customer flow, revenue, partnerships | references/business-adapter.md plus references/domain-adapters.md | | Brand, naming, logo, colors, launch, campaign, product positioning | references/brand-adapter.md plus references/five-phase-domain-map.md | | Career, promotion, job search, interview, negotiation, leadership | references/career-adapter.md plus references/life-and-omen-adapter.md if symbolic timing is requested | | Relationship, family, romance, friendship, roommate, communication, conflict | references/relationship-adapter.md plus references/ethics-and-limits.md | | Product strategy, onboarding, UX, activation, retention, roadmap | references/product-adapter.md plus references/five-phase-domain-map.md | | Learning, study, exams, focus, memory, practice routines | references/learning-adapter.md plus references/wellbeing-adapter.md if sleep/stress is involved | | Sleep, stress, focus, energy, burnout, health-adjacent environment | references/wellbeing-adapter.md plus references/ethics-and-limits.md | | Contract, dispute, compliance, lease, legal-adjacent risk | references/legal-adjacent-adapter.md plus references/ethics-and-limits.md | | Business, brand, career, product, learning, wellbeing, relationships, negotiation | references/domain-adapters.md | | Substantial consultation, cross-domain question, finance/life/space brief | references/consultation-brief.md; run python fengshui-master/scripts/create_brief.py "" | | Markdown report scaffold or reusable deliverable | references/reporting-protocol.md; run python fengshui-master/scripts/generate_report.py "" | | Cross-domain routing | Run python fengshui-master/scripts/domain_router.py "" | | Method or school selection | Run python fengshui-master/scripts/method_selector.py "" | | Structured floor-plan, office, shop, room, or site JSON | references/floorplan-schema.md; run python fengshui-master/scripts/analyze_floorplan.py | | Basic terms, bagua, five phases, qi, yin-yang, 24 mountains | references/foundation.md | | Bagua sector, trigram, direction, life area, wealth corner, career area, relationship area | Run python fengshui-master/scripts/bagua_map.py --direction or python fengshui-master/scripts/bagua_map.py --life-area | | Roads, rivers, mountains, building shapes, external sha, landscape | references/forms-and-environment.md | | Which feng shui school to apply | references/schools.md | | Home, office, shop, room, floor plan, desk, bed, kitchen | references/analysis-templates.md | | Remedies, cures, colors, mirrors, plants, water, screens | references/remedies.md | | Moving date, opening date, renovation timing, 24 solar terms, seasonal qi, new moon, full moon, moon phase, annual stars, tai sui, sui po, san sha, nine periods | references/timing-and-date-selection.md; run python fengshui-master/scripts/solar_terms.py for seasonal qi context, python fengshui-master/scripts/moon_phase.py for moon phase context, and python fengshui-master/scripts/annual_afflictions.py for common annual directional cautions | | Xuan kong, flying stars, Period 9, Luo Shu flight, star meanings | references/xuan-kong-flying-stars.md | | Yin house, burial sites, cemetery plots, ancestral graves | references/yin-house.md | | Chinese terms, pronunciation, glossary, translation cautions | references/glossary.md | | Example response structures, comparisons, intake templates | references/case-patterns.md | | Finished answer examples and tone samples | references/sample-readings.md | | Claims about luck, health, money, relationships, pregnancy, disasters | references/ethics-and-limits.md | | Classical sources, research posture, adding new references | references/sources.md | | Source lineage, classical anchors, school map, modern extension boundaries | references/classical-source-map.md | | Compass bearing to 24 mountains | Run python fengshui-master/scripts/luopan.py | | Birth-year ming gua / eight mansions personal directions | Run python fengshui-master/scripts/minggua.py --sex | | Gregorian year to heavenly stem / earthly branch scaffold | Run python fengshui-master/scripts/ganzhi.py | | Annual tai sui / sui po / san sha directional cautions | Run python fengshui-master/scripts/annual_afflictions.py | | 24 solar terms / seasonal qi timing context | Run python fengshui-master/scripts/solar_terms.py | | San yuan / xuan kong 20-year period | Run python fengshui-master/scripts/periods.py | | Basic Luo Shu flying-star scaffold | Run python fengshui-master/scripts/flying_stars.py --period |

Response Pattern

Structure substantial readings as:

1. Inputs and assumptions: what was provided and what is inferred.
2. Method: the schools or reference frames used.
3. Findings: outside environment, entrance, circulation, major rooms, personal placements, timing if relevant.
4. Recommendations: ranked actions with reason, difficulty, and trade-offs.
5. Missing data: what would improve confidence.
6. Cultural note: when a claim is symbolic, school-specific, or contested.

Deterministic Tools

Use scripts/create_brief.py to create a structured consultation brief before substantial readings:

python fengshui-master/scripts/create_brief.py "Should I buy this stock next month using feng shui?" --pretty

With structured floor-plan JSON:

python fengshui-master/scripts/create_brief.py "Review this apartment layout" --floorplan fengshui-master/assets/sample-floorplan.json --pretty

Treat the brief as an intake contract, not the final answer.

Use scripts/generate_report.py to turn a consultation brief into a Markdown report scaffold:

python fengshui-master/scripts/generate_report.py "Should I buy this stock next month using feng shui?"

Write a sample file:

python fengshui-master/scripts/generate_report.py "Should I buy this stock next month using feng shui?" --output fengshui-master/assets/sample-finance-report.md

Use the generated report as a scaffold. Remove placeholder text and fill sections only with supplied evidence, transparent assumptions, and clearly labeled traditional interpretations.

Use scripts/luopan.py when converting a compass degree into one of the 24 mountains. Example:

python fengshui-master/scripts/luopan.py 187 --pretty

Do not use the script as proof of auspiciousness by itself. It only maps a bearing to a traditional sector.

Use scripts/bagua_map.py when mapping a bagua sector, trigram, direction, or life-area symbolism:

python fengshui-master/scripts/bagua_map.py --direction southeast --pretty
python fengshui-master/scripts/bagua_map.py --life-area wealth --method symbolic --pretty

Do not use the script as proof of wealth, relationship, health, or career outcomes. It only maps later-heaven bagua symbolism and method labels; compass bagua, door-aligned bagua, eight mansions, and flying stars must not be mixed silently.

Use scripts/minggua.py for a common eight mansions personal gua calculation:

python fengshui-master/scripts/minggua.py 1990 --sex male --pretty

Clarify that exact year boundaries may vary by lineage, especially around li chun.

Use scripts/ganzhi.py for a simple Gregorian-year heavenly stem and earthly branch scaffold:

python fengshui-master/scripts/ganzhi.py 2026 --pretty

Treat this as year-level symbolic context only. For birth years or annual luck near late January or early February, confirm the li chun or lunar-year boundary used by the chosen lineage. Do not present it as a complete bazi, zi wei, qimen, liuren, or almanac calculation.

Use scripts/annual_afflictions.py for common annual directional cautions such as tai sui, sui po, and san sha:

python fengshui-master/scripts/annual_afflictions.py 2026 --pretty

Treat annual cautions as a secondary timing layer for renovation, moving, opening, and disturbance questions. Do not use them as a full almanac, flying-star, bazi, qimen, or date-selection engine.

Use scripts/moon_phase.py for approximate new moon / full moon / lunar phase context:

python fengshui-master/scripts/

…

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [JackieL233](https://github.com/JackieL233)
- **Source:** [JackieL233/fengshui-master](https://github.com/JackieL233/fengshui-master)
- **License:** MIT

Install and usage instructions live in the source repository linked above.